Repository navigation
Using Rubi
This page is for everyone who talks to Rubi, in a direct chat or in a group. For the details of every command, see the command reference. Group admins also have the group admin guide.
- Sending commands
- Buttons and tappable commands
- Arguments: members, numbers, times
- Live replies, cooldowns and errors
- Reminders
- Polls, games and events
- Tasks, time zones and personal defaults
- Web lookups, Reddit and X
- Away and last seen
- Reporting a message
- Privacy: what Rubi sees and keeps
A command is a message that starts with /, followed by the command name and its arguments:
/weather Oslo
/remind 10m stretch
/poll Movie night? | Friday | Saturday
-
In a direct chat with Rubi, everything you send goes to Rubi. Plain messages (not commands) get a short hint to
send
/help. -
In a group, Rubi only reacts to commands. If you @mention Rubi without a command, it answers with a
/helphint. Replying to one of Rubi's messages doesn't count as talking to it. -
/helpshows the commands you can use in that chat: commands that need a group role you don't have, or that only work in DMs or groups, are left out (the list says how many and why). Group admins can also turn commands off for their group; those are hidden too. -
/help utilitylists one category with descriptions./help remindshows everything about one command: usage, arguments, examples, who can use it, where it works and its cooldown. - An unknown command gets a "did you mean" suggestion in DMs. In groups Rubi stays quiet by default, because groups often have several bots.
Command names are case-insensitive (/Weather works). Some commands have short aliases, like /r for /reddit; the
reference lists them.
SimpleX has no inline buttons, so Rubi's "buttons" are commands you can tap. Where tapping works depends on the app:
-
Direct chats with Rubi: commands in Rubi's messages are always tappable, and the
/button in the message bar shows Rubi's command menu. -
Groups: only when an owner turned on Rubi's group menu (
/groupmenu). Then commands are tappable and the/menu shows Rubi's commands there too. -
Anywhere else, commands show as
codeyou can copy, and optional buttons (like π "again") are left out. Buttons you need, such as β confirm or β cancel, still show as code.
Reactions work everywhere: vote in polls, trivia and would-you-rather by reacting to Rubi's message with the option's emoji. SimpleX allows these reactions: π π π π π’ β€ π β , up to 3 per person per message.
Confirmations: destructive commands (like /kick) ask first. Answer with the β
/confirm or β /cancel shown,
or type yes / no. Only the person who ran the command can answer, and the question expires after a minute.
The usage line in /help <command> shows each argument: <name> is required, [name] is optional, name... takes
the rest of the message, and a|b means one of those words. If an argument is wrong, Rubi shows the usage line and a
link to the details.
-
Words with spaces: put them in quotes,
"like this". The last argument usually takes the rest of the message anyway, so quotes are rarely needed. -
Members (groups only): an @mention (
@bob), a name with spaces in quotes (@'Jo Do'), or a member id (#12, shown by/members). If a name matches several members, Rubi asks you to use the id. -
Numbers may have commas between digits:
1,000,2d1,000,1,234.5. -
Durations:
30s,10m,1h30m,2d,1w,2 hours,1h 30m. -
Times:
18:30,6pm,6:30am,tomorrow 9:00. A bare number like6isn't a time. -
Dates:
dec 24,24 december,december 24th 18:00,2026-12-24 8am,friday 9:00,on fri. Without a time it's 9:00. A date without a year that has already passed means next year.
Times use your time zone if you set one with /time set <place> in a DM with Rubi, otherwise the time zone of the
server Rubi runs on. Times in groups always use the server's.
- Live replies: commands that take a moment (web lookups, Reddit, X) post a placeholder right away, like "β³ Working on /weather 3s", and edit it into the answer. Your app shows it as being typed.
- Cooldowns: after you use a command, you wait a couple of seconds before using the same one again (some commands wait longer; see the reference). If you send many commands quickly, Rubi asks you to slow down and ignores the rest for a few seconds. Typos don't start a cooldown, and neither does a web service that failed to answer.
-
Errors: β means the input wasn't right (Rubi says what to fix), π means you need a role you don't have, and π«
means the command doesn't work in this kind of chat. π₯ "Something went wrong" is a bug: it comes with an
Error refthat the people running Rubi can look up. - While Rubi is offline: commands sent while Rubi was down are not answered when it comes back (unless whoever runs it changed that), so you don't get a burst of late replies. Just send the command again.
/remind 10m stretch
/remind 1h30m check the oven
/remind 18:30 call mom
/remind tomorrow 9:00 dentist
/remind dec 24 18:00 wrap presents
/remind friday 9:00 send the report
Rubi replies in the same chat when it's time, quoting your /remind message. In groups it @mentions you. Reminders
survive restarts.
-
Repeating:
/remind every 2h drink water,/remind every day 9:00 standup,/remind every monday 18:00 gym. Intervals must be at least an hour, andevery day/every <weekday>need a time. Daily and weekly reminders stay at the same clock time when daylight saving time changes. Runs missed while Rubi was offline are skipped, not sent all at once. -
For someone else (groups): start with their name,
/remind @bob 1h check the PRor/remind @'Jo Do' every friday 16:00 timesheet. The reminder @mentions them and says it's from you. You own it: it's in your/remindersand only you can cancel it. -
See and cancel:
/reminderslists yours in this chat, with a β to cancel each one (/unremind <id>). Only the person who set a reminder can cancel it. -
Snooze: when a one-off reminder goes off, tap π€ 10m, π€ 1h or π€ tomorrow under it (where commands are
tappable), or reply to it with
/snooze 30m(any time:/snooze tomorrow 9:00). You can snooze it for a day after it goes off, whether you set it or it's for you. - Limits: at least 10 seconds ahead, at most a year, and 25 reminders per person.
- If you leave a group, or are removed, the reminders you set there, and the ones others set for you there, are cancelled.
Polls: /poll Pizza tonight? | yes | no | maybe. Separate the question and up to 8 options with |. With no
options it's a π/π poll. Vote by reacting with the option's emoji, or tap its vote button where commands are tappable.
Each person has one vote, and changing your reaction changes it. Only the person who started a poll can close it with
/endpoll <id> (the button is on the poll), which shows the final result.
-
Several picks: start with
multi,/poll multi Which days work? | Mon | Tue | Wed, and everyone can pick as many options as they like. SimpleX allows 3 reactions per person on a message, so more picks need the vote buttons. -
Closing by itself: start with a duration (1 minute to 30 days),
/poll 2h Pizza tonight? | yes | no. The poll shows when it closes. Both work together:/poll multi 1d β¦. - Polls and games that run out of time show that on their message instead of keeping buttons that no longer work.
Trivia: /trivia (or /trivia hard) asks a question; answer by reacting with the emoji of your answer. The answer
is revealed after 30 seconds. /trivia tournament 5 medium plays several rounds (2β10) and keeps score.
Would you rather: /wyr asks a random question, or /wyr Explore space | Explore the ocean asks yours. Vote with
reactions; you can change your vote.
Hangman: /hangman starts a game for the whole chat. Anyone guesses with /hangman e or the whole word
(/hangman rocket); six wrong guesses and it's over. Whoever started it can stop it.
Tic-tac-toe (groups): /ttt @bob challenges Bob; you play β and go first. Move with /ttt 5 (cells 1β9, or tap
the cell buttons where commands are tappable). Either player can /ttt stop.
Daily word: everyone gets the same 5-letter word each day (UTC). Guess with /word crane: π© right letter in the
right spot, π¨ in the word but elsewhere, β¬ not in the word. You have six guesses a day. In a group the guesses are
shared, so it's a race: the first to solve it scores a win. /word shows today's board, /word scores the chat's
leaderboard.
Events (groups): /event new tomorrow 18:30 | Europe/London | Book club creates an event with a time zone and
visible RSVPs. Members answer with the π yes, π maybe or π no reactions, or /event rsvp <id> yes|maybe|no.
/event list shows upcoming events. Rubi posts a reminder when the event starts. Only the creator can
/event cancel <id>.
More fun: /8ball, /coinflip, /rps rock, /roll 2d6+3, /choose tea or coffee, /joke, /fact, /quote,
/xkcd.
-
Tasks:
/todo add bring projector,/todo list,/todo claim <id>,/todo done <id>,/todo reopen <id>,/todo remove <id>,/todo clear. In a DM it's your personal list; in a group it's the group's shared list (up to 100 tasks). The creator or whoever has a task can complete or reopen it; only the creator can remove it or, in groups, give it to someone with/todo assign <id> @member./todo clearremoves your own completed tasks. -
Time zone:
/time Tokyoshows the time anywhere. In a DM,/time set Londonsaves your time zone, which/remindthen uses for clock times and dates./time at 2030-01-01T18:00:00Z | UTC | America/New_Yorkconverts an exact moment between zones. -
Personal defaults (DMs only):
/prefs set weather Oslo,/prefs set country de,/prefs set currency EUR. When you leave out the place, country or currency in a DM, Rubi uses these./prefsshows them and/prefs reset <key>removes one.
/weather, /wiki, /define, /currency, /crypto, /country, /holidays, /time, /github, /npm, /hn,
/dns, /whois, /status, /deals, /translate and /xkcd fetch information from public services (each command's details say which). They
answer with a live reply.
Reddit and X posts: /reddit <link> (or /r) and /x <link> show the post's text and stats and attach its images
and videos. Shortcuts:
-
Reply to a message that contains a link with just
/ror/xto show that post. -
Add
-to skip the media:/r <link>-,/x <link> -, or reply with/r -. Rubi then only lists the media. - Media of NSFW or sensitive posts is only sent in DMs.
Translate: /translate de good morning (or /tr) translates into German; the source language is detected. Name it
when the guess is wrong: /translate fr>en bonjour. Languages are codes (de, pt-BR) or names (german). Up to 500
characters at a time. The text is sent to MyMemory (translated.net).
Replies as input: reply to a message with /translate de, /define, /qr, /hash sha256, /base64 encode or
/cleanlink to use that message's text, just like /r and /x with links.
Other tools: /calc (2+3)*4^2, /convert 32 F to C (offline units), /qr <text>, /uuid, /hash sha256 <text>,
/base64 encode <text>, /timestamp, /cleanlink <url> (removes tracking parameters without opening the link), and
/password (DMs only, so it isn't shown to a group).
-
/afk lunch, back at 2(or/away,/brb) marks you as away in that group. When someone @mentions you, Rubi replies that you're away, with your reason (at most once a minute). As soon as you post again, Rubi welcomes you back and the away status ends. -
/seen @bobshows when Bob last posted in the group (to the minute), and whether they're away. Rubi only knows about messages since it joined the group.
In a group, reply to a message with /report and, if you like, a reason: /report spam link. The group's admins who
turned on the moderation log get the message and your reason by DM. If Rubi is a
moderator, it removes your /report message so the report stays discreet, and confirms by DM when it can reach you.
You can send one report a minute. If nobody receives reports in that group yet, Rubi tells you so instead.
Rubi is a regular SimpleX contact or group member. It sees what you send to it in DMs, and the messages in groups it's in. What it keeps:
- Your settings (time zone, personal defaults, personal tasks) and group settings (rules, welcome message, banned words, warnings, events, tasks) are stored in Rubi's own SimpleX database, attached to that chat.
-
Scheduled things (reminders, event reminders, timed blocks, timed polls), reminders that can still be snoozed
(for a day), open polls and games, the daily word boards and scores, command usage counts (for
/stats), and the time each member last posted in a group (for/seen) and away statuses are kept in a small state file next to that database. -
Web lookups go to free public services that need no key: Open-Meteo, Wikipedia, Free Dictionary, Frankfurter
(ECB rates), CoinGecko, Cloudflare DNS-over-HTTPS, RDAP (rdap.org), GitHub, npm, Nager.Date, Hacker News, JokeAPI,
Useless Facts, DummyJSON (quotes), xkcd, CheapShark and Open Trivia DB.
/translatesends the text you translate to MyMemory (translated.net), and/statusopens the site you ask about./redditreads posts from the Arctic Shift archive and/xuses the FxTwitter API; both download media from the sites' own servers./feedfetches the feeds a group follows. These services see the server's IP address, never yours, and whoever runs Rubi can route them through Tor./countryuses built-in data from mledoze/countries (ODbL) and makes no request. - Rubi doesn't log message contents. It logs which commands ran, for whom and how long they took.
- Group admins can ask Rubi to DM them a moderation log of moderation actions in
their group, which can include removed messages and the messages members
/report. Nothing from that log is posted in the group. - When Rubi leaves a group, it deletes that group's scheduled jobs, polls, word boards, snoozable reminders and last-seen records. When you leave a group, your last-seen and away records there are deleted, along with the reminders you set there and the ones set for you.
- Web lookups go to the public service the command names (for example Open-Meteo for
/weather). Whoever runs Rubi can route them through Tor.
These pages are generated from guide/ in the repository. Edit them there: changes made here are overwritten.