# 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_bypass` | Yes | No | Auto-approve all permissions | | `/disable_bypass` | Yes | No | Restore normal permission prompts | | `/bypass` | No | Yes | Toggle bypass permissions (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 | | `/mode` | Yes | Yes | Switch agent mode (code, architect, etc.) | | `/model` | Yes | Yes | Switch agent model | | `/thought` | Yes | Yes | Toggle thinking/reasoning mode | | `/dangerous` | Yes | Yes | Toggle dangerous/bypass permissions mode | | `/switch` | Yes | Yes | Switch to a different agent mid-conversation | | `/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 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 ` 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 [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_bypass` / `/disable_bypass` (Telegram) · `/bypass` (Discord) Toggle bypass permissions for the current session. When enabled, all permission requests are auto-approved without showing buttons. Run inside a session topic. See [Permissions](permissions.md) 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. Supports a 3-level cascade: session override → adapter default → global default. ``` /outputmode low # set adapter default to low /outputmode high # set adapter default to high /outputmode reset # reset adapter default to global default /outputmode session high # override for the current session only /outputmode session reset # clear the session override ``` - `low` — compact icon grid (minimal noise) - `medium` — tool titles, descriptions, output summaries (default) - `high` — full inline output, plan list, viewer links for long results, thinking viewer link On Discord, an action row with `[🔇 Low] [📊 Medium] [🔍 High] [❌ Cancel]` buttons appears below the tool card while the agent is working, so you can switch mode without typing a command. ### `/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, marks the session as cancelled, and permanently 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. ### `/mode [mode-name]` Switch the agent's operating mode. Without an argument, shows a menu of available modes declared by the agent (e.g., `code`, `architect`, `ask`). ``` /mode # show available modes /mode code # switch to code mode /mode architect # switch to architect mode ``` Available modes depend on the agent — they are declared via the ACP config options protocol. ### `/model [model-name]` Switch the agent's model. Without an argument, shows available models. ``` /model # show available models /model claude-sonnet # switch to a specific model ``` ### `/thought [on|off]` Toggle the agent's thinking/reasoning mode. When enabled, the agent shows its reasoning process. ``` /thought # toggle thinking mode /thought on # enable thinking /thought off # disable thinking ``` ### `/dangerous [on|off]` Toggle dangerous/bypass permissions mode for the current session. When enabled, the agent can perform destructive operations without confirmation prompts. This is equivalent to `/bypass` but routed through the agent's config options when available. ``` /dangerous # toggle dangerous mode /dangerous on # enable (auto-approve all permissions) /dangerous off # disable (restore normal prompts) ``` ### `/switch [agent-name | label on|off]` Switch to a different agent mid-conversation. The current conversation history is injected into the new agent so context is preserved. ``` /switch # show a menu of available agents /switch claude # switch directly to the claude agent /switch gemini # switch directly to the gemini agent /switch label on # enable agent name labels in history during switches /switch label off # disable agent name labels ``` If you switch back to a previously used agent without having sent any user prompts in the current session, the old session is resumed (if the agent supports resume). Otherwise a new session is created with the conversation history injected. The session thread or topic remains the same across all switches — only the agent handling the conversation changes. See [Agent Switch](../features/agent-switch.md) for the full feature guide. ### `/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.