跳到主要内容
本文尚未翻译

本文暂时显示英文原文,中文翻译正在进行中。翻译完成后将自动更新。

原文链接:English Version

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
/new (alias: /reset)Start a new session (fresh session ID + history)
/clearClear screen and start a new session
/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])
/stopKill all running background processes
/queue <prompt> (alias: /q)Queue a prompt for the next turn (doesn't interrupt the current agent response). Note: /q is claimed by both /queue and /quit; the last registration wins, so /q resolves to /quit in practice. Use /queue explicitly.
/resume [name]Resume a previously-named session
/statusbar (alias: /sb)Toggle the context/model status bar on or off
/background <prompt> (alias: /bg)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.
/btw <question>Ephemeral side question using session context (no tools, not persisted). Useful for quick clarifications without affecting the conversation history.
/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.
/branch [name] (alias: /fork)Branch the current session (explore a different path)

Configuration

CommandDescription
/configShow current configuration
/model [model-name]Show or change the current model. Supports: /model claude-sonnet-4, /model provider:model (switch providers), /model custom:model (custom endpoint), /model custom:name:model (named custom provider), /model custom (auto-detect from endpoint)
/providerShow available providers and current provider
/promptView/set custom system prompt
/personalitySet a predefined personality
/verboseCycle tool progress display: off → new → all → verbose. Can be enabled for messaging via config.
/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).
/yoloToggle YOLO mode — skip all dangerous command approval prompts.

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-mcp (alias: /reload_mcp)Reload MCP servers from config.yaml
/pluginsList installed plugins and their status

Info

CommandDescription
/helpShow this help message
/usageShow token usage, cost breakdown, and session duration
/insightsShow usage insights and analytics (last 30 days)
/platforms (alias: /gateway)Show gateway/messaging platform status
/pasteCheck clipboard for an image and attach it
/profileShow active profile name and home directory

Exit

CommandDescription
/quitExit the CLI (also: /exit). See note on /q under /queue above.

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 map a short alias to a longer prompt. Configure them in ~/.hermes/config.yaml:

quick_commands:
review: "Review my latest git diff and suggest improvements"
deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
morning: "Check my calendar, unread emails, and summarize today's priorities"

Then type /review, /deploy, or /morning in the CLI. Quick commands are resolved at dispatch time and are not shown in the built-in autocomplete/help tables.

Alias Resolution

Commands support prefix matching: typing /h resolves to /help, /mod resolves to /model. When a prefix is ambiguous (matches multiple commands), the first match in registry order wins. Full command names and registered aliases always take priority over prefix matches.

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.
/stopKill all running background processes and interrupt the running agent.
/model [provider:model]Show or change the model. Supports provider switches (/model zai:glm-5), custom endpoints (/model custom:model), named custom providers (/model custom:local:qwen), and auto-detect (/model custom).
/providerShow provider availability and auth status.
/personality [name]Set a personality overlay for the session.
/retryRetry the last message.
/undoRemove the last exchange.
/sethome (alias: /set-home)Mark 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-mcp (alias: /reload_mcp)Reload MCP servers from config.
/yoloToggle YOLO mode — skip all dangerous command approval prompts.
/commands [page]Browse all commands and skills (paginated).
/approve [session|always]Approve and execute a pending dangerous command. session approves for this session only; always adds to permanent allowlist.
/denyReject a pending dangerous command.
/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, /statusbar, and /plugins are CLI-only commands.
  • /verbose is CLI-only by default, but can be enabled for messaging platforms by setting display.tool_progress_command: true in config.yaml. When enabled, it cycles the display.tool_progress mode and saves to config.
  • /status, /sethome, /update, /approve, /deny, and /commands are messaging-only commands.
  • /background, /voice, /reload-mcp, /rollback, and /yolo work in both the CLI and the messaging gateway.
  • /voice join, /voice channel, and /voice leave are only meaningful on Discord.