斜杠命令参考

Hermes 有两个斜杠命令界面，都由 hermes_cli/commands.py 中的中央 COMMAND_REGISTRY 驱动：

• 交互式 CLI 斜杠命令 — 由 cli.py 分发，带有来自注册表的自动补全
• 消息斜杠命令 — 由 gateway/run.py 分发，带有从注册表生成的帮助文本和平台菜单

安装的技能也在两个界面上作为动态斜杠命令暴露。这包括内置技能如 /plan，它打开计划模式并在活动工作区/后端工作目录下的 .hermes/plans/ 中保存 Markdown 计划。

Interactive CLI slash commands

在 CLI 中输入 / 打开自动补全菜单。内置命令不区分大小写。

Session

Command	Description
/new (alias: /reset)	Start a new session (fresh session ID + history)
/clear	Clear screen and start a new session
/history	Show conversation history
/save	Save the current conversation
/retry	Retry the last message (resend to agent)
/undo	Remove the last user/assistant exchange
/title	Set a title for the current session (usage: /title My Session Name)
/compress	Manually compress conversation context (flush memories + summarize)
/rollback	List or restore filesystem checkpoints (usage: /rollback [number])
/stop	Kill 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

Command	Description
/config	Show 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)
/provider	Show available providers and current provider
/personality	Set a predefined personality
/verbose	Cycle tool progress display: off → new → all → verbose. Can be enabled for messaging via config.
/reasoning	Manage reasoning effort and display (usage: /reasoning [level
/skin	Show or change the display skin/theme
`/voice [on	off
/yolo	Toggle YOLO mode — skip all dangerous command approval prompts.

Tools & Skills

Command	Description
`/tools [list	disable
/toolsets	List available toolsets
`/browser [connect	disconnect
/skills	Search, install, inspect, or manage skills from online registries
/cron	Manage scheduled tasks (list, add/create, edit, pause, resume, run, remove)
/reload-mcp (alias: /reload_mcp)	Reload MCP servers from config.yaml
/plugins	List installed plugins and their status

Info

Command	Description
/help	Show this help message
/usage	Show token usage, cost breakdown, and session duration
/insights	Show usage insights and analytics (last 30 days)
/platforms (alias: /gateway)	Show gateway/messaging platform status
/paste	Check clipboard for an image and attach it
/profile	Show active profile name and home directory

Exit

Command	Description
/quit	Exit the CLI (also: /exit). See note on /q under /queue above.

Dynamic CLI slash commands

Command	Description
/<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

消息网关在 Telegram、Discord、Slack、WhatsApp、Signal、Email 和 Home Assistant 聊天中支持以下内置命令：

Command	Description
/new	Start a new conversation.
/reset	Reset conversation history.
/status	Show session info.
/stop	Kill 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).
/provider	Show provider availability and auth status.
/personality [name]	Set a personality overlay for the session.
/retry	Retry the last message.
/undo	Remove the last exchange.
/sethome (alias: /set-home)	Mark the current chat as the platform home channel for deliveries.
/compress	Manually compress conversation context.
/title [name]	Set or show the session title.
/resume [name]	Resume a previously named session.
/usage	Show token usage, estimated cost breakdown (input/output), context window state, and session duration.
/insights [days]	Show usage analytics.
`/reasoning [level	show
`/voice [on	off
/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.
/yolo	Toggle YOLO mode — skip all dangerous command approval prompts.
/commands [page]	Browse all commands and skills (paginated).
`/approve [session	always]`
/deny	Reject a pending dangerous command.
/update	Update Hermes Agent to the latest version.
/help	Show messaging help.
/<skill-name>	Invoke any installed skill by name.

Notes

• /skin, /tools, /toolsets, /browser, /config, /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.