Commands¶
Send a command as a message. The /command@your_bot form works too and is required in groups. Command words are not case sensitive. A forwarded message is never a command. A command the bot does not know goes to the model as ordinary text.
There are no /start and /help commands. Telegram's command menu is set by the bot at every start.
"Admin chat" means the admin's private chat. Elsewhere the bot answers "This command is not available to you."
| Command | What it does | Who | Where |
|---|---|---|---|
/new |
Archives this conversation and starts a fresh session. Also clears a tainted session. | Anyone allowed | Private chat and groups |
/sessions |
Lists your last 5 earlier conversations, newest first. | Anyone allowed | Private chat and groups |
/resume <n> |
Goes back to session n from /sessions and archives the current one. |
Anyone allowed | Private chat and groups |
/status |
Shows how the node is doing: verdict, models, delivery, jobs, problems. | Admin | Admin chat |
/last |
Shows what the last turn did. | Admin | Admin chat |
/tasks |
Lists reminders and scheduled tasks, each with Details, Delete and Run now buttons. | Admin | Admin chat |
/memory |
Lists what the bot remembers, by topic. /memory <topic> shows one topic. |
Admin | Admin chat |
/modules |
Lists modules. See Modules for the verbs. | Admin | Admin chat |
/why |
Reply to a module's message with /why to see how it came about: the runs that led to it, each with when it ran, what started it, how long it took, how it ended, what it called and the names of the values it wrote. Never shows the module's own text. |
Admin | Admin chat |
/cells |
Shows sensors and switches (cells) with their values. | Admin | Admin chat |
/mcp |
Lists the connected MCP servers with their state, last sign-in and number of tools, each with a Disconnect button. See Connecting an MCP server. | Admin | Admin chat |
/secrets |
Lists secret names, dates and which modules use them. Never shows a value. /secrets rm <module or node> <NAME> removes one; /secrets reset drops all after a key mismatch. |
Admin | Admin chat |
/metrics |
Sends metrics as a picture. Optional filter: all, ganglion, runtime, process or a word. |
Admin | Admin chat |
/commands |
Shows the host-command switch. /commands on or /commands off flips it. |
Admin | Admin chat |
/update |
Shows the running version and the newest release. /update install vX.Y.Z installs a signed release and restarts into it; /update rollback goes back to the previous version. The reply, and the notice of a new release, have Install and Roll back buttons that do the same. See Updating. |
Admin | Admin chat |
/restart |
Stops the node cleanly so a supervisor starts it again. Settings outside modules apply then. Once it is up again it says so in the same chat, with how long it took. | Admin | Admin chat |
/reset is an unlisted alias of /new.
To ask the agent about a /status answer, reply to it: the agent reads the whole answer. A reply to another command's answer tells the agent only which command it was, since some answers (/modules, /cells) show text a module wrote, which the agent never reads.
To change settings without editing the file, ask the agent: see Settings from the chat.
If the node runs without a supervisor (a restart policy in your container platform, or systemd), /restart just stops it. See Operations.
A private chat with someone who is not the admin gets no reply, so these commands matter only to the admin in practice. In a group, only /new, /sessions and /resume work.