-
-
Notifications
You must be signed in to change notification settings - Fork 1
Command Reference
Emiel Kollof edited this page Mar 31, 2026
·
11 revisions
Complete list of commands provided by weechat-xmpp-improved.
/account list
/account add <name> <jid> <password>
/account connect <name>
/account disconnect <name>
/account reconnect <name>
/account delete <name>
/account register <name> <jid> <password> # create account on server (XEP-0077)
/account unregister <name> # cancel account on server (XEP-0077)
/account password <name> <new-password> # change password in-band (XEP-0077)
| Command | Description |
|---|---|
/enter <jid> |
Join a MUC room |
/join <jid> |
Alias for /enter
|
/open <jid> |
Open a direct chat (PM) |
/query <jid> [msg] |
Alias for /open; optional opening message |
/msg <text> |
Send a message in the current buffer |
/me <text> |
Send a /me action (XEP-0245) |
/ephemeral <seconds> <text> |
Send an ephemeral message that auto-deletes after N seconds (XEP-0466) |
/notify [<jid>] [always|on-mention|never] |
Get or set per-chat notification preference (XEP-0492) |
/invite <jid> [reason] |
Invite a user to the current MUC (XEP-0249) |
/selfping |
Verify MUC membership (XEP-0410) |
/edit |
Interactive picker: choose a sent message to correct (XEP-0308) |
/edit-to <id> <text> |
Correct a specific message by ID (used by /edit picker) |
/retract |
Interactive picker: choose a sent message to delete (XEP-0424) |
/moderate [reason] |
Interactive picker: choose a MUC message to moderate (XEP-0425) |
/react <emoji> |
React to the last received message (XEP-0444) |
/reply |
Interactive picker: choose a message to reply to (XEP-0461) |
/reply <text> |
Reply to the last received message (XEP-0461) |
/reply-to <id> <text> |
Reply to a specific message by ID (used by /reply picker) |
/spoiler [hint: <hint> :: ] <text> |
Send a spoiler message (XEP-0382) |
/buzz |
Send attention request to current PM contact (XEP-0224) |
/whois [jid] |
Retrieve vCard (XEP-0054 / XEP-0292) |
/setvcard <field> <value> |
Publish a vCard field (XEP-0054) |
/setavatar <filepath> |
Publish avatar image (XEP-0084) |
| Command | Description |
|---|---|
/kick <nick> [reason] |
Kick an occupant (requires moderator role) |
/ban <jid> [reason] |
Ban a user by JID (requires admin/owner role) |
/topic [text] |
Set or clear the room topic |
/nick [newnick] |
Change your nickname in the current MUC |
Affiliation takes precedence over role when both apply.
| Prefix | Role / Affiliation | Meaning |
|---|---|---|
~ |
affiliation: owner | Room owner — full control |
& |
affiliation: admin | Administrator — can grant/revoke roles |
@ |
role: moderator | Can kick and mute participants |
% |
affiliation: member | Registered member (voice in members-only rooms) |
+ |
role: participant | Standard occupant with voice |
? |
role: visitor | Read-only in moderated rooms |
! |
affiliation: outcast | Banned from the room |
. |
(none) | No role or affiliation set yet |
| Command | Description |
|---|---|
/block <jid> [jid ...] |
Block one or more JIDs |
/unblock [jid ...] |
Unblock; no arguments unblocks all |
/blocklist |
List all blocked JIDs |
| Command | Description |
|---|---|
/omemo |
Enable OMEMO for the current buffer |
/omemo check |
Verify OMEMO bundle is published |
/omemo republish |
Republish OMEMO:2 + legacy nodes |
/omemo status |
Show device ID and status |
/omemo reset-keys |
Reset key database (forces renegotiation) |
/omemo fetch [jid] [device-id] |
Force devicelist/bundle refresh |
/omemo kex [jid] [device-id] |
Force key transport now |
/pgp [keyid|status|reset] |
Manage PGP encryption |
/plain |
Disable encryption (use plaintext) |
| Command | Description |
|---|---|
/upload |
Interactive file picker |
/upload <path> |
Upload a file directly (XEP-0363, XEP-0447) |
| Command | Description |
|---|---|
/mam [days] |
Fetch MAM history (default: 7 days; XEP-0313) |
/mam prefs |
Show current MAM preferences (XEP-0441) |
/mam prefs default <always|never|roster> |
Set default archiving policy |
/mam prefs always <jid> |
Add a JID to the always-archive list |
/mam prefs never <jid> |
Add a JID to the never-archive list |
| Command | Description |
|---|---|
/disco [jid] |
Discover services and features (XEP-0030) |
/adhoc <jid> [node] [id] [field=value ...] |
Execute ad-hoc commands (XEP-0050) |
/roster |
Display contact list |
/roster add <jid> [name] |
Add a contact |
/roster del <jid> |
Remove a contact |
/list [keywords] |
Search public MUC rooms (XEP-0433) |
/bookmark |
List PEP bookmarks (XEP-0402) |
/bookmark add [jid] [name] |
Add a bookmark |
/bookmark del <jid> |
Remove a bookmark |
/bookmark autojoin <jid> <on|off> |
Toggle autojoin |
| Command | Description |
|---|---|
/feed |
Fetch subscriptions from all auto-discovered PubSub services |
/feed discover |
List auto-discovered PubSub services |
/feed discover --all |
Fetch every node from every discovered service |
/feed <service-jid> |
Fetch all subscribed nodes on a specific service |
/feed <service-jid> --all |
Discover and fetch all nodes via disco#items |
/feed <service-jid> <node> |
Fetch a specific node into a dedicated buffer |
/feed ... --limit N |
Override the per-node item limit (default: 20) |
/feed ... --before <id> |
RSM paging: fetch items older than <id> (XEP-0059) |
/feed ... --latest |
Clear saved RSM cursor; return to the newest page |
/feed subscribe <service> <node> |
Subscribe to a PubSub node (XEP-0060) |
/feed unsubscribe <service> <node> |
Unsubscribe from a PubSub node |
/feed subscriptions <service> |
List all subscribed nodes on a service |
Each fetched node opens in its own dedicated WeeChat buffer. The RSM cursor is
persisted in LMDB so the next /feed call continues from where you left off.
Use --latest to reset the cursor and go back to the newest page. Items already
displayed in a previous fetch are not re-shown (LMDB deduplication).
Each displayed item is assigned a short #N alias (shown in green). Use #N
in place of the full item-id in any write subcommand when running from within
a feed buffer.
| Command | Description |
|---|---|
/feed post <service> <node> [--open] [--title <t>] <text> |
Publish a post as an Atom entry |
/feed post [--open] [--title <t>] <text> |
Publish from a feed buffer (service/node inferred) |
/feed post -- <text> |
Post body starts with JID-like word — use -- to force short form |
/feed reply <service> <node> <item-id|#N> <text> |
Threaded reply via thr:in-reply-to
|
/feed reply #N <text> |
Short form reply from a feed buffer |
/feed repeat <service> <node> <item-id> [comment] |
Boost/repeat a post (XEP-0472 §4.5) |
/feed repeat #N [comment] |
Short form boost from a feed buffer |
/feed retract <service> <node> <item-id> |
Retract (delete) a published post |
/feed retract #N |
Short form retract from a feed buffer |
/feed comments <service> <node> <item-id|#N> |
Fetch the comments node for a post |
/feed comments #N |
Short form fetch comments from a feed buffer |
--open sets pubsub#access_model=open (public, no subscription needed).
Server errors (forbidden, item-not-found, etc.) are reported in the buffer.
Subscribe/unsubscribe feedback is printed in the originating buffer.
| Command | Description |
|---|---|
/ping [jid] |
Send XMPP ping; defaults to server (XEP-0199) |
/mood [mood [text]] |
Publish mood via PEP (XEP-0107) |
/activity [category[/specific] [text]] |
Publish activity via PEP (XEP-0108) |
/xml <stanza> |
Send raw XML (advanced/debug) |
/xmpp |
Show plugin version |
/trap |
Trigger debug breakpoint (developers only) |
Several commands open an in-buffer interactive picker when invoked without
arguments (/edit, /retract, /moderate, /reply, /upload):
| Key | Action |
|---|---|
↑ / ↓
|
Navigate up/down |
Enter |
Confirm selection |
q / Esc
|
Cancel and return to previous buffer |