0xmrpeter 16e0884354 fix(output-mode): wire outputViewerLink, fix verbosity callback key, update docs
- 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
2026-03-30 01:52:51 +07:00

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 only
  • medium — 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.