- DisplaySpecBuilder: add TunnelServiceInterface constructor injection, implement outputViewerLink/outputFallbackContent for long output (>15 lines or >800 chars) - DisplaySpecBuilder: fix buildThoughtSpec indicator to "Thinking..." - ActivityTracker: store and pass tunnelService to DisplaySpecBuilder, pass sessionContext to all buildToolSpec calls - setupVerbosityCallbacks: write outputMode instead of deprecated displayVerbosity key - /verbosity static command description updated to note deprecation - Docs: update displayVerbosity → outputMode across configuration, chat-commands, troubleshooting, and architecture docs; add /outputmode command reference
7.5 KiB
Chat Commands
OpenACP responds to commands sent in your chat platform. This page covers every available command, how to use it, and which platforms support it.
Platform comparison
| Command | Telegram | Discord | Notes |
|---|---|---|---|
/new |
Yes | Yes (/new) |
Create a new agent session |
/newchat |
Yes | Yes | New chat, same agent and workspace |
/cancel |
Yes | Yes | Cancel current session prompt |
/status |
Yes | Yes | Show session or system status |
/sessions |
Yes | Yes | List all sessions |
/agents |
Yes | Yes | Browse installed and available agents |
/install |
Yes | Yes | Install an agent |
/menu |
Yes | Yes | Show interactive menu |
/resume |
Yes | No | Resume from Entire checkpoints |
/settings |
Yes | Yes | Change configuration in-chat |
/doctor |
Yes | Yes | Run system diagnostics |
/tunnel |
Yes | No | Create a public URL for a local port |
/tunnels |
Yes | No | List active tunnels |
/enable_dangerous |
Yes | No | Auto-approve all permissions |
/disable_dangerous |
Yes | No | Restore normal permission prompts |
/dangerous |
No | Yes | Toggle dangerous mode (Discord) |
/text_to_speech |
Yes | No | Toggle TTS for a session |
/tts |
No | Yes | Toggle TTS (Discord) |
/outputmode |
Yes | Yes | Set output detail level (replaces /verbosity) |
/verbosity |
Yes | Yes | Deprecated — use /outputmode instead |
/usage |
Yes | No | View token usage and cost |
/archive |
Yes | No | Archive a session topic |
/summary |
Yes | No | Generate an AI summary of a session |
/handoff |
Yes | Yes | Continue session in your terminal |
/integrate |
Yes | Yes | Manage agent integrations |
/restart |
Yes | Yes | Restart OpenACP |
/update |
Yes | Yes | Update to latest version |
/clear |
Yes | Yes | Clear assistant history |
/help |
Yes | Yes | Show help text |
Command reference
/new [agent] [workspace]
Create a new agent session. If you omit arguments, OpenACP walks you through an interactive picker: choose your agent, then your project directory.
/new # interactive picker
/new claude # pick workspace interactively
/new claude ~/code/my-project # create directly
On Telegram, each session gets its own forum topic. On Discord, a new thread is created in the configured channel.
/newchat
Start a fresh conversation with the same agent and workspace as the current session. Run this inside an existing session topic or thread. Useful when you want a clean context without changing your setup.
/cancel
Abort the currently running prompt. The session stays active — you can send another message immediately. Run this inside a session topic or thread.
/status
Show status for the current session (when run inside a session topic) or a system-wide summary of all sessions (when run in the main chat).
Session status includes: name, agent, status, workspace path, and queue depth.
/sessions
List all sessions with their status and names. On Telegram, this also provides cleanup buttons to remove finished, errored, or all sessions.
/agents
Browse installed and available agents. Installed agents are shown first, then the full registry with install buttons. The registry is paginated six entries at a time.
/install <name>
Install an agent by name.
/install claude
/install gemini
Progress updates appear in-line. After installation, a button lets you start a session with the new agent immediately. If post-install setup steps are needed (e.g. API key configuration), they appear as copyable commands.
/menu
Display an interactive inline keyboard with quick access to: New Session, Sessions, Status, Agents, Settings, Integrate, Restart, Update, Help, and Doctor.
/resume (Telegram only)
Resume a session with conversation history loaded from Entire checkpoints. Supports multiple query formats:
/resume # latest 5 sessions
/resume pr 19 # by pull request number
/resume branch main # by branch name
/resume commit e0dd2fa4 # by commit hash
/resume f634acf05138 # by checkpoint ID
/resume https://entire.io/gh/.../... # by Entire URL
/resume https://github.com/org/repo/pull/19
After the query, a workspace picker lets you choose which repository to load context from.
/settings
Open an interactive settings panel. Toggle and select configuration values without editing config files. Some changes take effect immediately; others require a restart. Changes that need a restart show a notification.
/doctor
Run system diagnostics. Checks configuration, agent dependencies, disk access, and connectivity. Results are shown inline with pass/warn/fail status. Fixable issues show a "Fix" button.
/tunnel <port> [label] (Telegram only)
Create a public HTTPS URL for a local port. Useful when an agent starts a dev server and you need to access it from outside.
/tunnel 3000
/tunnel 3000 my-app
/tunnel stop 3000
/tunnels (Telegram only)
List all active tunnels with their public URLs and stop buttons.
/enable_dangerous / /disable_dangerous (Telegram) · /dangerous (Discord)
Toggle dangerous mode for the current session. When enabled, all permission requests are auto-approved without showing buttons. Run inside a session topic. See Permissions for details.
/text_to_speech [on|off] (Telegram) · /tts [on|off] (Discord)
Toggle text-to-speech for the current session. Without an argument, enables TTS for the next message only. With on, enables persistently. With off, disables.
/outputmode low|medium|high
Set how much detail OpenACP shows for agent activity. You can also set a per-session override:
/outputmode low # set globally for this channel
/outputmode high # show full detail including inline output
/outputmode session high # override for the current session only
/outputmode session reset # clear the session override
low— minimal output, title onlymedium— balanced (default)high— full detail including inline output for short results, viewer links for long output
/verbosity low|medium|high (deprecated)
Alias for /outputmode. Use /outputmode instead.
/usage [today|week|month] (Telegram only)
Show a token usage and cost report. Without arguments, shows today, this week, and this month. Pass a period to see just that range.
/archive (Telegram only)
Archive the current session: stops the agent, removes the session record, and deletes the Telegram topic. This cannot be undone.
/summary (Telegram only)
Ask the agent to summarize what it has accomplished in the current session. Works inside a session topic.
/handoff
Generate a terminal command to continue the current session in your local terminal. The agent session ID is included so context is preserved.
/integrate
Manage agent integrations — for example, installing the handoff integration that lets you resume sessions from the terminal.
/restart
Restart OpenACP. Use this after configuration changes that cannot be hot-reloaded, or when something is stuck.
/update
Check for a newer version and update in place. OpenACP restarts automatically after a successful update.
/clear
Reset the assistant session history. Only works in the Assistant topic on Telegram.
/help
Show a quick-reference help message.