0xmrpeter 2075fc4819 docs(telegram): update terminology and document new prerequisite behavior
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-05 22:28:14 +07:00

259 lines
10 KiB
Markdown

# 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 <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_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.