Telegram commands
The SupaCloud Telegram bot accepts the following commands. Link your account
first with /link before using task or workspace commands.
| Command | Description |
|---|---|
/status |
Active tasks — sends an inline-button list of recent tasks; tap a task for Logs / Cancel / Follow (+ Back / Close). |
/task <id> |
Task details. |
/run <project> <agent> <prompt> |
Launch a task. |
/issues [project] |
Issue-to-task wizard: inline buttons step through Project → Issue → Agent → Launch. |
/backlog [project] |
Auto-developer backlog board. |
/follow <id> / /f <id> |
Enter live mode and stream task events. |
/unfollow |
Exit live mode. |
/logs <id> |
Recent task events. |
/intervene <id> <msg> |
Send a message to a running task. |
/cancel <id> |
Cancel a task. |
/approvals [tool|workflow] |
List pending human decision gates; the bare command lists the workflow human-gates (the default). tool lists the interactive tool/question/visual gates. Each workflow gate carries inline Approve/Reject buttons (ADR 0045). |
/skills [approve|reject <id>] |
List the open induced-skill proposals, or approve/reject one by id. Deciding is workspace-admin only (ADR 0045). |
/workflows |
List workflows. |
/runs |
Recent runs. |
/runners |
Runner status. |
/resources |
Resource list. |
/usage |
Per-provider subscription-saturation windows for the active workspace (admin/owner only) (ADR 0045). |
/budget |
The $-budget status (cap, spend, remaining) — a member read (ADR 0045). |
/workspace [name] / /ws |
Show the active workspace, or switch to name. |
/workspaces |
List all workspaces. |
/org |
Show the active organization (name, kind, plan, member count) — read-only. |
/autonomy [0-100] |
Show the resolved effective autonomy (level, named stop, policy preview). Setting from chat is not yet available — use the web settings or the Management API to change the level (ADR 0045). |
/approval_mode <project> [none|pr_draft|human_gate] |
Show or set a project’s PR-review approval mode. Setting is workspace-admin only (ADR 0045). |
/schedule list|add|pause|resume|delete |
Manage schedules. |
/debug on|off |
Toggle debug mode for your current live/follow session to reveal internal operations in the stream (#583). Available only while a workspace admin has opened the debug ceiling. |
/density reduced|chatty |
Set the persistent live-feed verbosity (reduced = lean, chatty = full thinking and tool detail). |
/language de|en |
Set the language. |
/link <token> |
Link your Telegram identity to a SupaCloud account using a one-time token. |
Live mode
Section titled “Live mode”After /follow (or /f), the bot enters live mode: each task step updates
a single in-place message (coalesced streaming, tool-line deduplication, thinking
shown). Any plain text you send while in live mode is forwarded to the task as an
intervention. Live mode stops automatically when the task completes. Send
/unfollow to exit early.
Launching a task with /run or the /issues wizard enters live mode
automatically on that chat, with an Unfollow button under the confirmation
so you can leave the stream in one tap. Following is per-chat: a task you start
from Telegram streams in Telegram only.
Debug mode
Section titled “Debug mode”/debug on turns on debug mode for your current live/follow session only,
revealing internal operations in the stream — MCP tool calls, scope resolution,
gate auto-resolves and danger escalations. /debug off turns it back off.
Debug output is gated by an allow-debug ceiling that a workspace admin opens
(it is off by default). With the ceiling closed, /debug on has no effect. The
setting is per session and ephemeral: it covers only the session you are
following, is never persisted, and is enforced server-side.
Account linking
Section titled “Account linking”/link <token> binds your Telegram identity to an existing SupaCloud account using
a one-time link token generated in Settings. You need to run this once before
workspace or task commands are available to you.
Task TL;DR notifications
Section titled “Task TL;DR notifications”When a task finishes, a short TL;DR — a status glyph and the outcome summary — is pushed to the task owner’s linked Telegram account. A per-account opt-out toggle in the chat-account settings turns it off. With no linked Telegram account there is nothing to push.