Skip to content

Command Reference

github-actions[bot] edited this page Nov 22, 2026 · 3 revisions

Every command, with the same information as /help <command> in the chat. New here? Start with the user guide; group admins, see the admin guide.

Reading the usage line: <name> is required, [name] is optional, name... takes the rest of the message, and a|b means one of those words. Members can be given as an @mention, a name (@'Jo Do' with spaces) or #id (see /members). Numbers may use commas (1,000).

Cooldown is how long one person waits before using the same command again (default 2 s). Bot admins skip cooldowns.

📖 General

Basics and bot info.

/about

About me: uptime, version and stats

Usage /about
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /info, /uptime

/help

List commands, or show details for one

/help lists categories and commands; /help adds descriptions; /help shows everything about one command.

Usage /help [command]
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /h, /commands, /start

Arguments

  • command (optional, word or "quoted text"): A command or category to show details for

Examples

  • /help
  • /help utility
  • /help remind

/invite

Get my SimpleX address (link + QR code)

Usage /invite
Where DMs and groups
Who Everyone
Cooldown 10 s
Aliases /address

/ping

Check I'm online and how fast I reply

Usage /ping
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /pong
Live reply yes: a placeholder appears right away and turns into the answer

/whoami

Show your ids and role (handy for setting up bot admins)

In a DM it shows your contact id — put it in RUBI_BOT_ADMINS to make yourself a bot admin. In a group it shows your member id and role.

Usage /whoami
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /me, /id

🛠 Utility

Handy tools.

/base64

Encode or decode Base64

Reply to a message with /base64 encode or /base64 decode to use that message's text.

Usage /base64 <encode|decode> [text...]
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /b64

Arguments

  • action (required, one of encode, decode): encode or decode
  • text (optional, text): The text (or reply to a message)

Examples

  • /base64 encode hello
  • /base64 decode aGVsbG8=

/calc

Calculator: /calc (2+3)*4^2

Supports + - * / % ^, parentheses, sqrt, abs, round, floor, ceil, sin, cos, tan, log, ln, exp, min, max, pi, e.

Usage /calc <expression...>
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /math, /calculate

Arguments

  • expression (required, text): What to calculate

Examples

  • /calc 2+2
  • /calc sqrt(2)*10
  • /calc 15% * 80

/choose

Pick one for you: /choose pizza | sushi | tacos

Separate options with |, commas, or the word "or".

Usage /choose <options...>
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /pick
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • options (required, text): Things to choose from

Examples

  • /choose pizza | sushi | tacos
  • /choose tea or coffee

/cleanlink

Remove tracking from a link

Works offline and never opens the URL. Signed or tokenized URLs are left unchanged rather than risking a broken link.

Usage /cleanlink [url...]
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /cleanurl

Arguments

  • url (optional, text): HTTP(S) URL

Examples

  • /cleanlink https://example.org/?utm_source=newsletter&id=7

/convert

Convert units offline: /convert 1,000 m ft

Length, mass, temperature, area, volume, speed, time, data, energy, power, pressure and angle. Use symbols or full names; add 'to' if you like. /convert units shows the categories and common units.

Usage /convert <query...>
Where DMs and groups
Who Everyone
Cooldown 2 s

Arguments

  • query (required, text): [to] , or units

Examples

  • /convert 1,000 m ft
  • /convert 32 F to C
  • /convert 2 cups mL
  • /convert units

/hash

Hash text: /hash sha256 hello

Reply to a message with /hash to hash that message's text.

Usage /hash <md5|sha1|sha256|sha512|sha3-256> [text...]
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /digest

Arguments

  • algorithm (required, one of md5, sha1, sha256, sha512, sha3-256): Hash algorithm
  • text (optional, text): Text to hash (or reply to a message)

Examples

  • /hash sha256 hello world
  • /hash md5 hello

/password

Generate a strong random password (DMs only)

Generated with a cryptographic RNG and not stored by Rubi separately. It remains in SimpleX chat history until you delete the message. Look-alike characters (0/O, 1/l/I) are left out. DMs only, so it isn't shown to a whole group.

Usage /password [length] [strong|alnum|pin]
Where Direct messages only
Who Everyone
Cooldown 1 s
Aliases /pass, /pw

Arguments

  • length (optional, whole number, 4–128): Length (4–128, default 20)
  • kind (optional, one of strong, alnum, pin): strong (default), alnum or pin

Examples

  • /password
  • /password 32
  • /password 6 pin

/poll

Start a poll: /poll Pizza tonight? | yes | no | maybe

Separate the question and options with |. With no options it's a 👍/👎 poll. Up to 8 options. Vote by reacting with an option's emoji (I add the reactions myself for polls with up to 3 options — they don't count as votes), or tap its vote button in DMs. One vote per person; only its creator can close it with /endpoll. Start with multi to let people pick several options (SimpleX allows 3 reactions per person, so more picks need the buttons), and/or a duration (1m to 30d) to close it automatically: /poll multi 2h Lunch? | pizza | sushi | tacos.

Usage /poll <poll...>
Where DMs and groups
Who Everyone
Cooldown 15 s

Arguments

  • poll (required, text): [multi] [duration] Question | option | option

Examples

  • /poll Movie night? | Friday | Saturday | Sunday
  • /poll Should we start a book club?
  • /poll 1h Pizza tonight? | yes | no
  • /poll multi Which days work? | Mon | Tue | Wed | Thu

/prefs

Your personal defaults

Defaults are used only in direct chats when a command omits a place, country or currency. Explicit arguments always win.

Usage /prefs [action] [value...]
Where Direct messages only
Who Everyone
Cooldown 2 s

Arguments

  • action (optional, word or "quoted text"): set, reset or list
  • value (optional, text): Preference and value

Examples

  • /prefs
  • /prefs set weather Oslo
  • /prefs reset currency

/qr

Make a QR code: /qr https://simplex.chat

Reply to a message with /qr to encode that message's text.

Usage /qr [text...]
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /qrcode

Arguments

  • text (optional, text): Text or link to encode (or reply to a message)

Examples

  • /qr https://simplex.chat

/remind

Set a reminder: /remind 10m stretch

When: a duration (30s, 10m, 1h30m, 2d, 1w), a clock time (18:30, 6pm, tomorrow 9:00) or a date (dec 24 18:00, 24 december, 2026-12-24 8am, friday 9:00; without a time it's 9:00). Clock times use your time zone from /time set (DMs), otherwise the server's. Repeat with every: every 2h (an hour at least), every day 9:00, every monday 18:00. In groups, start with @member to remind someone else (only you can cancel it). Reminders survive restarts. When a one-off reminder goes off, tap 💤 or reply to it with /snooze 30m to get it again later (for a day).

Usage /remind <what...>
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /remindme, /reminder

Arguments

  • what (required, text): When, then what to remind you about

Examples

  • /remind 10m stretch
  • /remind 1h30m check the oven
  • /remind tomorrow 9:00 call mom
  • /remind dec 24 18:00 wrap presents
  • /remind every day 9:00 standup
  • /remind @bob 1h check the PR

/reminders

List your reminders in this chat

Usage /reminders
Where DMs and groups
Who Everyone
Cooldown 2 s

/roll

Roll dice: /roll 2d6+3, /roll d20, /roll 100

Usage /roll [dice]
Where DMs and groups
Who Everyone
Cooldown 1 s
Aliases /dice

Arguments

  • dice (optional, word or "quoted text"): NdM±K (e.g. 2d6+3), dM, or a number for 1–N

Examples

  • /roll
  • /roll 2d6+3
  • /roll d20
  • /roll 100

/time

Current time anywhere: /time Tokyo

Give a city or an IANA zone (Europe/Berlin). In a DM, /time set saves your zone — then /time shows it and /remind uses it for clock times.

Usage /time [place...]
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /clock, /tz

Arguments

  • place (optional, text): City, country or time zone — or: set

Examples

  • /time Tokyo
  • /time Europe/Berlin
  • /time set London

/timestamp

Convert Unix timestamps and dates

No argument: the current time. A number: Unix seconds (or milliseconds if it's 13+ digits). Anything else: parsed as a date (ISO 8601 works best).

Usage /timestamp [value...]
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /ts, /epoch, /unix

Arguments

  • value (optional, text): Unix time or a date

Examples

  • /timestamp
  • /timestamp 1700000000
  • /timestamp 2030-01-01T00:00:00Z

/todo

Personal or group task list

Use add, list, claim, done, reopen, remove, clear and (in groups) assign @member. Tasks are stored in this chat; creators and assignees can complete or reopen a task, only its creator can assign or remove it, and clear removes your own completed tasks.

Usage /todo [action] [value...]
Where DMs and groups
Who Everyone
Cooldown 2 s

Arguments

  • action (optional, word or "quoted text"): add, list, claim, done, reopen, assign, remove or clear
  • value (optional, text): Task id or text (assign: id and @member)

Examples

  • /todo add bring projector
  • /todo list
  • /todo claim abc123
  • /todo done abc123
  • /todo assign abc123 @bob
  • /todo clear

/uuid

Generate UUIDs (v4 random, or v7 time-ordered)

Usage /uuid [count] [v4|v7]
Where DMs and groups
Who Everyone
Cooldown 1 s
Aliases /guid

Arguments

  • count (optional, whole number, 1–20): How many (1–20)
  • version (optional, one of v4, v7): v4 (default) or v7

Examples

  • /uuid
  • /uuid 5
  • /uuid 3 v7

🌐 Web

Look things up online.

/country

Facts about a country: /country Japan

Name, ISO code (de, usa) or common alternative (UK) all work. Data is built in (world-countries, ODbL), so no web request is made.

Usage /country <name...>
Where DMs and groups
Who Everyone
Cooldown 2 s

Arguments

  • name (required, text): Country name or code

Examples

  • /country Japan
  • /country de
  • /country UK

/crypto

Crypto price: /crypto btc

Prices from CoinGecko. Optionally add a currency: /crypto eth eur

Usage /crypto <coin> [currency]
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /coin, /price
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • coin (required, word or "quoted text"): Coin name or symbol
  • currency (optional, word or "quoted text"): Fiat currency (default usd)

Examples

  • /crypto btc
  • /crypto monero eur

/currency

Convert money: /currency 20 usd eur

European Central Bank reference rates via frankfurter.dev (updated on working days). Leave out the target for a few common ones.

Usage /currency <query...>
Where DMs and groups
Who Everyone
Cooldown 3 s
Aliases /fx
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • query (required, text): [amount] [to] — e.g. 20 usd eur, 100 gbp to jpy

Examples

  • /currency 20 usd eur
  • /currency 100 gbp to jpy
  • /currency eur

/deals

Current PC game deals: /deals

Finds a game by title and shows its Steam app id, historical low and every current store deal from CheapShark, with prices in USD and links through CheapShark.

Usage /deals <title...>
Where DMs and groups
Who Everyone
Cooldown 5 s
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • title (required, text): Game title

Examples

  • /deals LEGO Batman
  • /deals Baldur's Gate 3

/define

Dictionary definition: /define serendipity

Reply to a message with /define to look up its first word.

Usage /define [word...]
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /dict, /dictionary
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • word (optional, text): English word (or reply to a message)

Examples

  • /define serendipity

/dns

DNS lookup: /dns simplex.chat MX

Uses DNS-over-HTTPS (Cloudflare), so lookups are encrypted.

Usage /dns <domain> [A|AAAA|MX|TXT|NS|CNAME|SOA|CAA]
Where DMs and groups
Who Everyone
Cooldown 3 s
Aliases /dig, /lookup
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • domain (required, word or "quoted text"): Domain name
  • type (optional, one of A, AAAA, MX, TXT, NS, CNAME, SOA, CAA): Record type (default A)

Examples

  • /dns simplex.chat
  • /dns simplex.chat MX
  • /dns simplex.chat TXT

/github

GitHub repo or user info: /github simplex-chat/simplex-chat

Usage /github <target>
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /gh
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • target (required, word or "quoted text"): owner/repo or a username

Examples

  • /github simplex-chat/simplex-chat
  • /github torvalds

/hn

Top stories on Hacker News

Usage /hn [count]
Where DMs and groups
Who Everyone
Cooldown 10 s
Aliases /hackernews, /news
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • count (optional, whole number, 1–10): How many (1–10, default 5)

Examples

  • /hn
  • /hn 10

/holidays

Upcoming public holidays: /holidays Germany

Data from Nager.Date — about 120 countries are covered.

Usage /holidays [country...]
Where DMs and groups
Who Everyone
Cooldown 3 s
Aliases /holiday
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • country (optional, text): Country name or code

Examples

  • /holidays Germany
  • /holidays us

/npm

npm package info: /npm simplex-chat

Usage /npm <package>
Where DMs and groups
Who Everyone
Cooldown 3 s
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • package (required, word or "quoted text"): Package name

Examples

  • /npm simplex-chat
  • /npm @simplex-chat/types

/reddit

Show a Reddit post: /reddit

Shows the post's title, text, score and upvote ratio, and attaches its images, GIFs, videos and files. Reply to a message containing a Reddit link with just /reddit or /r to show that post. Append - to the link, or reply with /reddit -, to report its media without downloading or attaching it. Works with post links, share links (reddit.com/r/…/s/…), redd.it links and post ids. Posts come from the Arctic Shift archive, so brand-new posts can take a few minutes to appear, and scores are refreshed about 36 hours after posting. Media of NSFW posts is only sent in DMs.

Usage /reddit [link...]
Where DMs and groups
Who Everyone
Cooldown 10 s
Aliases /r
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • link (optional, text): Post link, share link or post id (or reply to a link)

Examples

  • /reddit https://www.reddit.com/r/running/comments/17snc7d/
  • /r https://www.reddit.com/r/running/s/3TzXiyxaMD

/status

Check if a website is up: /status example.com

Only public addresses are allowed (no local network).

Usage /status <url>
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /isup, /up
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • url (required, word or "quoted text"): Website or URL

Examples

  • /status simplex.chat

/translate

Translate text: /translate de good morning

Give the target language (a code like de or pt-BR, or a name like german), then the text — or reply to a message with /translate de. The source language is detected; name it with fr>en if the guess is wrong. Up to 500 characters per translation. The text is sent to MyMemory (translated.net) to be translated.

Usage /translate <lang> [text...]
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /tr
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • lang (required, word or "quoted text"): Target language, or source>target
  • text (optional, text): Text to translate (or reply to a message)

Examples

  • /translate de good morning
  • /translate fr>en bonjour tout le monde
  • /translate japanese thank you

/weather

Weather now and the next 3 days: /weather Oslo

Data from Open-Meteo (free, no tracking key).

Usage /weather [place...]
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /w, /forecast
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • place (optional, text): City or place

Examples

  • /weather Oslo
  • /weather New York

/whois

Domain or IP owner: /whois simplex.chat

Registrar, dates, status, name servers and DNSSEC for domains; network name, range and country for IP addresses. Uses RDAP (rdap.org), the successor of WHOIS.

Usage /whois <target>
Where DMs and groups
Who Everyone
Cooldown 3 s
Aliases /rdap
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • target (required, word or "quoted text"): Domain or IP address

Examples

  • /whois simplex.chat
  • /whois 1.1.1.1

/wiki

Wikipedia summary: /wiki SimpleX Chat

Usage /wiki <query...>
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /wikipedia
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • query (required, text): What to look up

Examples

  • /wiki Ada Lovelace
  • /wiki Double ratchet algorithm

/x

Show a post from X (Twitter): /x

Shows the post's author, text, replies/reposts/likes/views, polls, community notes and quoted posts, and attaches its photos, videos and GIFs (including the quoted post's). Reply to a message containing an X link with just /x to show that post. Append - to the link, or reply with /x -, to report its media without downloading or attaching it. Posts are fetched through the FxTwitter API. Media of sensitive posts is only sent in DMs.

Usage /x [link...]
Where DMs and groups
Who Everyone
Cooldown 5 s
Aliases /twitter, /tweet
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • link (optional, text): x.com or twitter.com post link (or reply to a link)

Examples

  • /x https://x.com/jack/status/20

🎲 Fun

Games and fun stuff.

/8ball

Ask the magic 8-ball

Usage /8ball <question...>
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /eightball, /ask
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • question (required, text): Your yes/no question

Examples

  • /8ball Will it rain tomorrow?

/coinflip

Flip a coin

Usage /coinflip
Where DMs and groups
Who Everyone
Cooldown 2 s
Aliases /flip
Live reply yes: a placeholder appears right away and turns into the answer

/fact

A random (useless) fact

Usage /fact
Where DMs and groups
Who Everyone
Cooldown 3 s
Aliases /funfact
Live reply yes: a placeholder appears right away and turns into the answer

/hangman

Play hangman together

Start with /hangman, then anyone guesses with /hangman or /hangman . 6 wrong guesses and it's over. One game per chat; the starter can stop it.

Usage /hangman [guess]
Where DMs and groups
Who Everyone
Cooldown none

Arguments

  • guess (optional, word or "quoted text"): A letter or the whole word

Examples

  • /hangman
  • /hangman e
  • /hangman rocket

/joke

A joke — the punchline arrives live

From JokeAPI in safe mode (no NSFW, religious, political, racist, sexist or explicit jokes).

Usage /joke [programming|pun|misc|spooky]
Where DMs and groups
Who Everyone
Cooldown 5 s
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • topic (optional, one of programming, pun, misc, spooky): programming, pun, misc or spooky

Examples

  • /joke
  • /joke programming

/quote

A random quote

Usage /quote
Where DMs and groups
Who Everyone
Cooldown 3 s
Aliases /inspire
Live reply yes: a placeholder appears right away and turns into the answer

/rps

Rock, paper, scissors against me

Usage /rps [rock|paper|scissors]
Where DMs and groups
Who Everyone
Cooldown 1 s
Aliases /rockpaperscissors

Arguments

  • move (optional, one of rock, paper, scissors): Your move

Examples

  • /rps rock

/trivia

Trivia question or tournament

Answers are revealed after 30 seconds. Questions from the Open Trivia Database. Start a tournament with /trivia tournament [2–10] [easy|medium|hard]; points accumulate across rounds.

Usage /trivia [input...]
Where DMs and groups
Who Everyone
Cooldown 10 s
Aliases /quiz
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • input (optional, text): [tournament] [rounds] [easy|medium|hard]

Examples

  • /trivia
  • /trivia hard
  • /trivia tournament 5 medium

/ttt

Tic-tac-toe vs a member

Challenge someone with /ttt @member; you play ❌ and go first. Move with /ttt <1-9>. Either player can stop with /ttt stop. Games expire after a day.

Usage /ttt [input...]
Where Groups only
Who Everyone
Cooldown none
Aliases /tictactoe

Arguments

  • input (optional, text): @member, a cell 1-9, or stop

Examples

  • /ttt @bob
  • /ttt 5
  • /ttt stop

/word

Daily word puzzle

Everyone gets the same word each day (UTC). Guess with /word : 🟩 right spot, 🟨 in the word, ⬜ not in it. Each player has 6 guesses a day; guesses are shared with the chat, and the first to solve it scores a win. /word scores shows the leaderboard.

Usage /word [guess]
Where DMs and groups
Who Everyone
Cooldown none

Arguments

  • guess (optional, word or "quoted text"): A 5-letter word, or scores

Examples

  • /word
  • /word crane
  • /word scores

/wyr

Would you rather? Vote A or B

Give two options separated by |, or leave it blank for a random question. One vote per person; changing your reaction or tapping the other option changes your vote.

Usage /wyr [options...]
Where DMs and groups
Who Everyone
Cooldown 10 s
Aliases /wouldyourather

Arguments

  • options (optional, text): Option A | option B

Examples

  • /wyr
  • /wyr Explore space | Explore the ocean

/xkcd

An xkcd comic (latest, random or by number)

Usage /xkcd [which]
Where DMs and groups
Who Everyone
Cooldown 3 s
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • which (optional, word or "quoted text"): latest (default), random, or a number

Examples

  • /xkcd
  • /xkcd random
  • /xkcd 927

👥 Groups

Group features.

/afk

Mark yourself as away: /afk lunch

While you're away, I tell people who @mention you. It ends as soon as you post again.

Usage /afk [reason...]
Where Groups only
Who Everyone
Cooldown 2 s
Aliases /away, /brb

Arguments

  • reason (optional, text): Why you're away

Examples

  • /afk
  • /afk lunch, back at 2

/antispam

Delete links from brand-new members (admins)

When on, links posted by members who joined less than 24 hours ago (and are below moderator) are deleted. I need to be a moderator or higher.

Usage /antispam [state]
Where Groups only
Who Group admins
Cooldown 2 s

Arguments

  • state (optional, yes/no): on or off

Examples

  • /antispam on
  • /antispam off

/event

Create and RSVP to a group event

Create one-off events with a timezone and visible yes/maybe/no RSVPs.

Usage /event [action] [value...]
Where Groups only
Who Everyone
Cooldown 2 s

Arguments

  • action (optional, word or "quoted text"): new, list, rsvp or cancel
  • value (optional, text): Event details or id/status

Examples

  • /event new tomorrow 18:30 | Europe/London | Book club
  • /event list
  • /event rsvp abc123 yes

/feed

RSS/Atom feeds for this group

/feed lists this group's feeds; admins use /feed add and /feed remove . Checked every 30 minutes, up to 10 feeds per group. Works with blogs and news sites (a page that links its feed is enough), GitHub (github.com///releases.atom), subreddits (reddit.com/r//.rss), YouTube channel pages and Mastodon profiles.

Usage /feed [list|add|remove] [target]
Where Groups only
Who Everyone
Cooldown 2 s
Aliases /rss

Arguments

  • action (optional, one of list, add, remove): list, add or remove
  • target (optional, word or "quoted text"): Feed URL (add) or id (remove)

Examples

  • /feed
  • /feed add https://github.com/simplex-chat/simplex-chat/releases.atom
  • /feed remove ab12cd

/filter

Delete messages with banned words (admins)

add/remove take words or phrases separated by commas; * matches the rest of a word (crypto* also blocks cryptocoin), and remove also takes * patterns. action: what else happens to the author (delete only, warn = a /warn, block = a timed /block, default 10m). level: normal, strict or max (send /filter level to compare them). The word list is only ever sent to you by DM (link your DMs with /modlog on). Moderators and admins aren't filtered, edits are checked too, and I need to be a moderator or higher.

Usage /filter [add|remove|list|clear|action|level] [words...]
Where Groups only
Who Group admins
Cooldown 2 s
Aliases /bannedwords

Arguments

  • action (optional, one of add, remove, list, clear, action, level): add, remove, list, clear, action or level
  • words (optional, text): Words or phrases (comma-separated), or the setting

Examples

  • /filter add spam, buy now, crypto*
  • /filter remove crypto*
  • /filter action block 1h
  • /filter level strict
  • /filter list

/groupinfo

About this group: members, roles and my settings here

Usage /groupinfo
Where Groups only
Who Everyone
Cooldown 5 s
Aliases /group, /gi

/groupmenu

Make my commands tappable here and add them to the / menu

SimpleX apps only make commands tappable in a group when the group profile has a command menu, and only owners can set it — so I need to be a group owner. /groupmenu off removes it.

Usage /groupmenu [state]
Where Groups only
Who Group owners
Rubi must be group owner (or higher)
Cooldown 10 s
Aliases /menu

Arguments

  • state (optional, yes/no): on (default) or off

Examples

  • /groupmenu
  • /groupmenu off

/link

Show or create this group's invite link (admins)

/link shows the link (creating one if needed), /link new replaces it, /link delete removes it. I need to be a group admin.

Usage /link [new|delete]
Where Groups only
Who Group admins
Rubi must be group admin (or higher)
Cooldown 10 s
Aliases /grouplink

Arguments

  • action (optional, one of new, delete): new or delete

/members

List group members and their roles

Usage /members
Where Groups only
Who Everyone
Cooldown 5 s
Aliases /who, /roster

/rules

Show the group rules (admins: /rules set …, /rules clear)

Usage /rules [set|clear] [text...]
Where Groups only
Who Everyone
Cooldown 2 s

Arguments

  • action (optional, one of set, clear): set or clear (admins)
  • text (optional, text): The rules (for set)

Examples

  • /rules
  • /rules set 1. Be kind. 2. No spam.

/seen

When a member last posted: /seen @bob

Counts messages since I joined the group (to the minute). Also shows whether they're /afk.

Usage /seen <member>
Where Groups only
Who Everyone
Cooldown 2 s
Aliases /lastseen

Arguments

  • member (required, group member (@mention or name)): Who

Examples

  • /seen @bob

/slowmode

Limit how often members can post (admins)

Members below moderator can send one message per interval; faster messages are deleted. Commands don't count. Interval: 5s to 6h. /slowmode off turns it off. I need to be a moderator or higher.

Usage /slowmode [interval...]
Where Groups only
Who Group admins
Cooldown 2 s

Arguments

  • interval (optional, text): e.g. 30s, 2m, or off

Examples

  • /slowmode 30s
  • /slowmode off

/toggle

Turn commands on or off in this group (admins)

Name commands or whole categories, separated by commas or spaces: /toggle off fun turns off every Fun command. Turned-off commands don't run here (for anyone, admins included), disappear from /help and from the group's / menu. /help and /toggle can't be turned off. /toggle alone lists what's off.

Usage /toggle [on|off] [commands...]
Where Groups only
Who Group admins
Cooldown 2 s

Arguments

  • state (optional, one of on, off): on or off
  • commands (optional, text): Commands or categories

Examples

  • /toggle off fun
  • /toggle off trivia, joke
  • /toggle on trivia
  • /toggle

/welcome

Greet new members (admins: /welcome set Hi {name}!)

{name} becomes an @mention of the new member and {group} the group name. /welcome off disables it, /welcome test previews it. /welcome goodbye says goodbye to members who leave on their own ({name} in bold, {group}); /welcome goodbye off turns it off.

Usage /welcome [set|off|test|goodbye] [text...]
Where Groups only
Who Group admins
Cooldown 2 s

Arguments

  • action (optional, one of set, off, test, goodbye): set, off, test or goodbye
  • text (optional, text): Welcome message (for set), or the goodbye message

Examples

  • /welcome set Welcome {name}! Read /rules please 🙂
  • /welcome test
  • /welcome off
  • /welcome goodbye Bye {name}, thanks for stopping by!
  • /welcome goodbye off

🛡 Moderation

Keep groups tidy (moderators/admins).

/block

Block a member for everyone (their messages are hidden)

Blocked members stay in the group but nobody sees their new messages. Add a duration (10m, 2h, 1d; up to 30 days) to unblock them automatically. Undo with /unblock.

Usage /block <member> [duration...]
Where Groups only
Who Group moderators
Rubi must be group moderator (or higher)
Cooldown 2 s
Aliases /mute

Arguments

  • member (required, group member (@mention or name)): Who to block
  • duration (optional, text): How long (default: until /unblock)

Examples

  • /block @troll
  • /block @troll 10m

/delete

Reply to a message with /delete to remove it for everyone

Works on members' messages (moderators) and on my own messages. The /delete message is removed too.

Usage /delete
Where Groups only
Who Group moderators
Rubi must be group moderator (or higher)
Cooldown none
Aliases /del, /rm

/kick

Remove a member from the group

Asks for confirmation first. Their earlier messages stay — remove single ones by replying to them with /delete.

Usage /kick <member> [reason...]
Where Groups only
Who Group admins
Rubi must be group admin (or higher)
Cooldown 3 s
Aliases /remove

Arguments

  • member (required, group member (@mention or name)): Who to remove
  • reason (optional, text): Why (shown in the group)

Examples

  • /kick @spammer advertising

/modlog

Get the group's moderation log by DM (admins)

In a group, /modlog on sends you every moderation action (kicks, blocks, warnings, deleted and filtered messages, setting changes) by DM, and /modlog off stops it. Nothing sensitive is posted in the group. If I can't reach you yet, I send you a contact request in the group. To use another profile (e.g. not the incognito one you joined with), send /modlog link to me in a DM from that profile, then /modlog on in the group.

Usage /modlog [on|off|link] [code]
Where DMs and groups
Who Everyone
Cooldown 5 s

Arguments

  • action (optional, one of on, off, link): on, off or link
  • code (optional, word or "quoted text"): Code from /modlog link

Examples

  • /modlog on
  • /modlog off
  • /modlog link
  • /modlog on 4f7a2c

/purge

Delete the last messages: /purge 10

Removes the newest messages for everyone (up to 50), after you confirm. Add a member to only remove theirs. Messages from members whose role is equal to or higher than yours or mine are left alone.

Usage /purge <count> [member]
Where Groups only
Who Group moderators
Rubi must be group moderator (or higher)
Cooldown 10 s

Arguments

  • count (required, whole number, 1–50): How many messages (1–50)
  • member (optional, group member (@mention or name)): Only this member's messages

Examples

  • /purge 10
  • /purge 20 @spammer

/report

Report a message to admins (reply)

Reply to a message with /report and an optional reason. Admins who turned on the moderation log (/modlog on) get it by DM, with the message text. If I'm a moderator, I remove your /report message so the report stays discreet, and confirm by DM when I can.

Usage /report [reason...]
Where Groups only
Who Everyone
Cooldown none

Arguments

  • reason (optional, text): Why (optional)

Examples

  • /report spam link
  • /report

/role

Change a member's role

You can't give a role higher than your own. I need a role at least as high as both the old and the new one.

Usage /role <member> <observer|author|member|moderator|admin|owner>
Where Groups only
Who Group admins
Rubi must be group admin (or higher)
Cooldown 2 s
Aliases /setrole, /promote

Arguments

  • member (required, group member (@mention or name)): Whose role to change
  • role (required, one of observer, author, member, moderator, admin, owner): New role

Examples

  • /role @alice moderator
  • /role @bob observer

/unblock

Unblock a member

Usage /unblock <member>
Where Groups only
Who Group moderators
Rubi must be group moderator (or higher)
Cooldown 2 s
Aliases /unmute

Arguments

  • member (required, group member (@mention or name)): Who to unblock

/unwarn

Clear a member's warnings

Usage /unwarn <member>
Where Groups only
Who Group moderators
Cooldown 2 s
Aliases /clearwarns

Arguments

  • member (required, group member (@mention or name)): Whose warnings to clear

/warn

Warn a member (auto-removed at the warning limit)

Warnings are stored per group. At the limit (default 3, change with /warn limit , 0 = never) I remove the member if I'm an admin. Admins can make warnings expire with /warn expire 30d: a member's warnings reset after that long without a new one (/warn expire off: never).

Usage /warn <member> [reason...]
Where Groups only
Who Group moderators
Cooldown 2 s

Arguments

  • member (required, word or "quoted text"): Who to warn (or: limit, expire)
  • reason (optional, text): Why (or the new limit / expiry)

Examples

  • /warn @bob please keep it civil
  • /warn limit 5
  • /warn expire 30d

/warnings

See warnings (yours, a member's, or everyone's for moderators)

Usage /warnings [member]
Where Groups only
Who Everyone
Cooldown 2 s
Aliases /warns

Arguments

  • member (optional, group member (@mention or name)): Whose warnings (moderators can see anyone's)

⚙️ Admin

Bot operator tools.

/broadcast

Send a message to all my contacts

Asks for confirmation, then sends with live progress. Contacts that deleted me are skipped.

Usage /broadcast <message...>
Where Direct messages only
Who Bot admins
Cooldown 2 s
Aliases /announce

Arguments

  • message (required, text): What to send

/groups

List the groups I'm in

Usage /groups
Where DMs and groups
Who Bot admins
Cooldown 2 s
Aliases /mygroups

/join

Make me join a group link or connect to an address

Works with SimpleX group links, contact addresses and one-time invitation links.

Usage /join <link>
Where DMs and groups
Who Bot admins
Cooldown 2 s
Aliases /connect
Live reply yes: a placeholder appears right away and turns into the answer

Arguments

  • link (required, word or "quoted text"): SimpleX link

/leave

Make me leave a group

In a group: /leave leaves that group. Anywhere: /leave (ids are in /groups).

Usage /leave [groupId]
Where DMs and groups
Who Bot admins
Cooldown 2 s

Arguments

  • groupId (optional, whole number): Group id (default: this group)

/reload

Reload command files and the app menu (no restart)

Picks up edited/new files in data/commands. Event handlers and src/ changes still need a restart.

Usage /reload
Where DMs and groups
Who Bot admins
Cooldown 2 s
Live reply yes: a placeholder appears right away and turns into the answer

/stats

Bot statistics: usage, memory, jobs

Usage /stats [mode]
Where DMs and groups
Who Bot admins
Cooldown 2 s

Arguments

  • mode (optional, word or "quoted text"): health for runtime diagnostics

⚙️ Buttons and helpers

Rubi's buttons send these. You rarely type them yourself, and they're not in /help.

/endpoll

Close a poll and show the result

Usage /endpoll <id>
Where DMs and groups
Who Everyone
Cooldown none
Aliases /closepoll

Arguments

  • id (required, word or "quoted text"): Poll id (from the poll message)

/snooze

Snooze a reminder that just went off

Tap a 💤 button under a reminder, or reply to the reminder with /snooze and when (10m, 1h, tomorrow 9:00; default 10m). Reminders can be snoozed for a day after they go off, by the person who set them or the person they're for.

Usage /snooze [when...]
Where DMs and groups
Who Everyone
Cooldown none

Arguments

  • when (optional, text): When: 10m, 1h, tomorrow 9:00 (the buttons add an id first)

Examples

  • /snooze 30m
  • /snooze tomorrow 9:00

/unremind

Cancel a reminder

Usage /unremind <id>
Where DMs and groups
Who Everyone
Cooldown none

Arguments

  • id (required, word or "quoted text"): Reminder id (see /reminders)

/cancel

Cancel a pending action

Usage /cancel [id]
Where DMs and groups
Who Everyone
Cooldown none
Aliases /no

Arguments

  • id (optional, word or "quoted text"): Interaction id

/confirm

Confirm a pending action

Usage /confirm [id]
Where DMs and groups
Who Everyone
Cooldown none
Aliases /yes

Arguments

  • id (optional, word or "quoted text"): Confirmation id

/page

Show another page of a list

Usage /page <id> <n>
Where DMs and groups
Who Everyone
Cooldown none

Arguments

  • id (required, word or "quoted text"): List id (from the button)
  • n (required, whole number, 1–…): Page number

/vote

Answer a poll or quiz button

Usage /vote <id> [choice...]
Where DMs and groups
Who Everyone
Cooldown none

Arguments

  • id (required, word or "quoted text"): Interaction id (from the button)
  • choice (optional, text): Your choice