Slash Command 参考

Hermes 有两个 slash command 表面，它们都由 hermes_cli/commands.py 中统一的 COMMAND_REGISTRY 驱动：

• 交互式 CLI slash command：由 cli.py 分发，并基于注册表提供自动补全
• 消息平台 slash command：由 gateway/run.py 分发，其帮助文本和平台菜单也由注册表生成

已安装技能也会在这两个表面上作为动态 slash command 暴露出来。这其中也包括像 /plan 这样的内置技能，它会开启 plan mode，并把 markdown 计划保存到相对于当前工作区/后端工作目录的 .hermes/plans/ 下。

交互式 CLI slash command

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

Session

Command	Description
/new（别名：/reset）	开始一个新会话（新的 session ID 与历史）
/clear	清屏并开始一个新会话
/history	显示对话历史
/save	保存当前对话
/retry	重试上一条消息（重新发送给 agent）
/undo	删除最近一次用户/助手往返
/title	为当前会话设置标题（用法：/title My Session Name）
/compress [focus topic]	手动压缩对话上下文（刷新记忆并生成摘要）。可选 focus topic 用于限制摘要保留的重点。
/rollback	列出或恢复文件系统 checkpoint（用法：/rollback [number]）
/snapshot [create|restore <id>|prune]（别名：/snap）	创建或恢复 Hermes 配置/状态快照。create [label] 新建，restore <id> 恢复，prune [N] 清理旧快照，无参数时列出全部。
/stop	杀掉所有运行中的后台进程
/queue <prompt>（别名：/q）	把 prompt 排入下一轮，不会中断当前 agent 回复。注意： /q 同时被 /queue 与 /quit 占用，最终以最后注册者为准，因此实际上会解析为 /quit，请显式使用 /queue。
/resume [name]	恢复一个已命名会话
/status	显示会话信息
/agents（别名：/tasks）	显示当前会话中的活动 agent 与运行中的任务
/background <prompt>（别名：/bg）	在独立后台会话中运行 prompt。当前会话保持可用，任务完成后结果会以面板形式显示。
/btw <question>	使用当前会话上下文发起一个短暂侧问，不用工具，也不会写入历史。
/plan [request]	加载内置 plan 技能，写 markdown 计划而不是执行工作。
/branch [name]（别名：/fork）	从当前会话分叉出一条新分支路径

Configuration

Command	Description
/config	显示当前配置
/model [model-name]	显示或切换当前模型。支持 /model claude-sonnet-4、/model provider:model、/model custom:model、/model custom:name:model、/model custom。使用 --global 可持久化到 config.yaml。注意： /model 只能在已配置 provider 间切换；新增 provider 需要退出会话后运行终端命令 hermes model。
/provider	显示可用 provider 与当前 provider
/personality	设置预定义人格
/verbose	循环切换工具进度显示：off → new → all → verbose。
/fast [normal|fast|status]	切换 fast mode，即 OpenAI Priority Processing / Anthropic Fast Mode。
/reasoning	管理推理强度与展示（用法：/reasoning [level|show|hide]）
/skin	显示或切换界面 skin/theme
/statusbar（别名：/sb）	打开或关闭上下文/模型状态栏
/voice [on|off|tts|status]	切换 CLI 语音模式和语音播报。录音按键由 voice.record_key 决定，默认是 Ctrl+B。
/yolo	切换 YOLO 模式，跳过所有危险命令审批提示。

Tools & Skills

Command	Description
/tools [list|disable|enable] [name...]	管理当前会话可用工具。禁用工具会把它从 agent toolset 中移除，并触发会话重置。
/toolsets	列出可用 toolset
/browser [connect|disconnect|status]	管理本地 Chrome CDP 连接。connect 会把浏览器工具挂到运行中的 Chrome 实例，disconnect 断开，status 查看状态。若未检测到调试器，会自动拉起 Chrome。
/skills	搜索、安装、查看或管理技能
/cron	管理定时任务（list、add/create、edit、pause、resume、run、remove）
/reload-mcp（别名：/reload_mcp）	从 config.yaml 重新加载 MCP server
/reload	把 .env 变量重新载入正在运行的会话，无需重启即可读取新 API key
/plugins	列出已安装插件及其状态

Info

Command	Description
/help	显示帮助
/usage	显示 token 使用量、成本拆分和会话时长
/insights	显示过去 30 天的使用分析
/platforms（别名：/gateway）	显示网关/消息平台状态
/paste	附加剪贴板图片
/copy [number]	把最近一次助手回复复制到剪贴板，或用数字指定倒数第 N 条。仅 CLI 可用。
/image <path>	为下一条 prompt 附加本地图片文件
/terminal-setup [auto|vscode|cursor|windsurf]	仅 TUI：为本地 VS Code 系编辑器终端配置更好的多行与撤销/重做键位兼容。
/debug	上传调试报告（系统信息 + 日志）并返回可分享链接。消息平台也可用。
/profile	显示当前 profile 名称与 home 目录
/gquota	显示 Google Gemini Code Assist 配额使用情况，仅当活动 provider 为 google-gemini-cli 时可用。

Exit

Command	Description
/quit	退出 CLI（也支持 /exit）。有关 /q 的冲突，请见 /queue 条目。

动态 CLI slash command

Command	Description
/<skill-name>	以按需命令方式加载任意已安装技能，例如 /gif-search、/github-pr-workflow、/excalidraw。
/skills ...	用于搜索、浏览、查看、安装、审计、发布和配置技能，包括官方 optional-skills 目录。

Quick Commands

用户可以在 ~/.hermes/config.yaml 中定义 quick command，把一个短别名映射到较长 prompt：

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"

之后你就可以在 CLI 中直接输入 /review、/deploy 或 /morning。Quick command 在分发时动态解析，不会出现在内置自动补全/帮助表格里。

别名解析

命令支持前缀匹配：例如输入 /h 会解析为 /help，输入 /mod 会解析为 /model。如果某个前缀有歧义（匹配多个命令），则以注册顺序中的第一个匹配项为准。完整命令名和显式别名的优先级始终高于前缀匹配。

消息平台 slash command

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

Command	Description
/new	开始一个新对话。
/reset	重置对话历史。
/status	显示会话信息。
/stop	杀掉所有后台进程，并中断正在运行的 agent。
/model [provider:model]	显示或切换模型。支持 provider 切换、自定义端点、命名 custom provider 和自动探测。使用 --global 可持久化到 config.yaml。注意： 新增 provider 或设置 API key 仍需在终端中运行 hermes model。
/provider	显示 provider 可用性与认证状态。
/personality [name]	为当前会话设置人格 overlay。
/fast [normal|fast|status]	切换 fast mode。
/retry	重试上一条消息。
/undo	删除最近一次往返。
/sethome（别名：/set-home）	将当前聊天标记为该平台的 home channel。
/compress [focus topic]	手动压缩上下文。可选 focus topic 用于限制保留重点。
/title [name]	设置或查看会话标题。
/resume [name]	恢复已命名会话。
/usage	显示 token 使用量、预估成本、上下文窗口状态与会话时长。
/insights [days]	显示使用分析。
/reasoning [level|show|hide]	调整推理强度或切换推理展示。
/voice [on|off|tts|join|channel|leave|status]	控制聊天中的语音回复。join/channel/leave 用于 Discord 语音频道模式。
/rollback [number]	列出或恢复文件系统 checkpoint。
/snapshot [create|restore <id>|prune]（别名：/snap）	创建或恢复 Hermes 配置/状态快照。
/background <prompt>	在独立后台会话中运行 prompt，完成后把结果发回同一聊天。
/plan [request]	加载内置 plan 技能，写计划而不是执行工作。
/reload-mcp（别名：/reload_mcp）	从配置中重新加载 MCP server。
/reload	重新加载 .env 变量。
/yolo	切换 YOLO 模式。
/commands [page]	分页浏览全部命令与技能。
/approve [session|always]	批准待执行的危险命令。session 仅当前会话有效，always 则加入永久 allowlist。
/deny	拒绝待执行的危险命令。
/update	把 Hermes Agent 更新到最新版本。
/restart	优雅重启网关，等当前运行中的任务排空后生效，并在恢复在线后向请求者发送确认。
/debug	上传调试报告并返回分享链接。
/help	显示消息平台帮助。
/<skill-name>	按技能名称调用任意已安装技能。

备注

• /skin、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/image、/terminal-setup、/statusbar 和 /plugins 是 CLI-only 命令。
• /verbose 默认也是 CLI-only，但可通过在 config.yaml 中设置 display.tool_progress_command: true 开放到消息平台。
• /sethome、/update、/restart、/approve、/deny 和 /commands 是 messaging-only 命令。
• /status、/background、/voice、/reload-mcp、/rollback、/snapshot、/debug、/fast 和 /yolo 同时适用于 CLI 与 消息网关。
• /voice join、/voice channel 和 /voice leave 只对 Discord 有意义。