Skip to main content

Slash Commands Reference

Hermes has two slash-command surfaces, both driven by a central COMMAND_REGISTRY in hermes_cli/commands.py:

  • Interactive CLI slash commands — dispatched by cli.py, with autocomplete from the registry
  • Messaging slash commands — dispatched by gateway/run.py, with help text and platform menus generated from the registry

Installed skills are also exposed as dynamic slash commands on both surfaces. That includes bundled skills like /plan, which opens plan mode and saves markdown plans under .hermes/plans/ relative to the active workspace/backend working directory.

Interactive CLI slash commands

Type / in the CLI to open the autocomplete menu. Built-in commands are case-insensitive.

Session

CommandDescription
/newStart a new conversation (reset history)
/resetReset conversation only (keep screen)
/clearClear screen and reset conversation (fresh start)
/historyShow conversation history
/saveSave the current conversation
/retryRetry the last message (resend to agent)
/undoRemove the last user/assistant exchange
/titleSet a title for the current session (usage: /title My Session Name)
/compressManually compress conversation context (flush memories + summarize)
/rollbackList or restore filesystem checkpoints (usage: /rollback [number])
/background <prompt>Run a prompt in a separate background session. The agent processes your prompt independently — your current session stays free for other work. Results appear as a panel when the task finishes. See CLI Background Sessions.
/plan [request]Load the bundled plan skill to write a markdown plan instead of executing the work. Plans are saved under .hermes/plans/ relative to the active workspace/backend working directory.

Configuration

CommandDescription
/configShow current configuration
/modelShow or change the current model
/providerShow available providers and current provider
/promptView/set custom system prompt
/personalitySet a predefined personality
/verboseCycle tool progress display: off → new → all → verbose
/reasoningManage reasoning effort and display (usage: /reasoning [level|show|hide])
/skinShow or change the display skin/theme
/voice [on|off|tts|status]Toggle CLI voice mode and spoken playback. Recording uses voice.record_key (default: Ctrl+B).

Tools & Skills

CommandDescription
/tools [list|disable|enable] [name...]Manage tools: list available tools, or disable/enable specific tools for the current session. Disabling a tool removes it from the agent's toolset and triggers a session reset.
/toolsetsList available toolsets
/browser [connect|disconnect|status]Manage local Chrome CDP connection. connect attaches browser tools to a running Chrome instance (default: ws://localhost:9222). disconnect detaches. status shows current connection. Auto-launches Chrome if no debugger is detected.
/skillsSearch, install, inspect, or manage skills from online registries
/cronManage scheduled tasks (list, add/create, edit, pause, resume, run, remove)
/reload-mcpReload MCP servers from config.yaml

Info

CommandDescription
/helpShow this help message
/usageShow token usage, cost breakdown, and session duration
/insightsShow usage insights and analytics (last 30 days)
/platformsShow gateway/messaging platform status
/pasteCheck clipboard for an image and attach it

Exit

CommandDescription
/quitExit the CLI (also: /exit, /q)

Dynamic CLI slash commands

CommandDescription
/<skill-name>Load any installed skill as an on-demand command. Example: /gif-search, /github-pr-workflow, /excalidraw.
/skills ...Search, browse, inspect, install, audit, publish, and configure skills from registries and the official optional-skills catalog.

Quick commands

User-defined quick commands from quick_commands in ~/.hermes/config.yaml are also available as slash commands. These are resolved at dispatch time, not shown in the built-in autocomplete/help tables.

Messaging slash commands

The messaging gateway supports the following built-in commands inside Telegram, Discord, Slack, WhatsApp, Signal, Email, and Home Assistant chats:

CommandDescription
/newStart a new conversation.
/resetReset conversation history.
/statusShow session info.
/stopInterrupt the running agent without queuing a follow-up prompt.
/model [provider:model]Show or change the model, including provider switches.
/providerShow provider availability and auth status.
/personality [name]Set a personality overlay for the session.
/retryRetry the last message.
/undoRemove the last exchange.
/sethomeMark the current chat as the platform home channel for deliveries.
/compressManually compress conversation context.
/title [name]Set or show the session title.
/resume [name]Resume a previously named session.
/usageShow token usage, estimated cost breakdown (input/output), context window state, and session duration.
/insights [days]Show usage analytics.
/reasoning [level|show|hide]Change reasoning effort or toggle reasoning display.
/voice [on|off|tts|join|channel|leave|status]Control spoken replies in chat. join/channel/leave manage Discord voice-channel mode.
/rollback [number]List or restore filesystem checkpoints.
/background <prompt>Run a prompt in a separate background session. Results are delivered back to the same chat when the task finishes. See Messaging Background Sessions.
/plan [request]Load the bundled plan skill to write a markdown plan instead of executing the work. Plans are saved under .hermes/plans/ relative to the active workspace/backend working directory.
/reload-mcpReload MCP servers from config.
/updateUpdate Hermes Agent to the latest version.
/helpShow messaging help.
/<skill-name>Invoke any installed skill by name.

Notes

  • /skin, /tools, /toolsets, /browser, /config, /prompt, /cron, /skills, /platforms, /paste, and /verbose are CLI-only commands.
  • /status, /stop, /sethome, /resume, and /update are messaging-only commands.
  • /background, /voice, /reload-mcp, and /rollback work in both the CLI and the messaging gateway.
  • /voice join, /voice channel, and /voice leave are only meaningful on Discord.