概述
hermes chat 用于启动与 Hermes Agent 的交互式对话。不带参数时进入默认 REPL/TUI；传入 -q 可运行单次提示并退出。你可以覆盖模型、供应商、工具集、技能、推理强度、会话恢复以及安全/审批行为。
用法
hermes chat [选项]
hermes # hermes chat 的简写选项
| 选项 | 说明 |
|---|---|
-q 查询, --query 查询 |
单次查询（非交互模式）。 |
--image 图片 |
为单次查询附加本地图片。 |
-m 模型, --model 模型 |
覆盖本次会话使用的模型。 |
-t 列表, --toolsets 列表 |
启用的工具集，逗号分隔。 |
--reasoning 级别 |
推理强度：none、minimal、low、medium、high、xhigh、max、ultra。 |
-s 技能, --skills 技能 |
预加载一个或多个技能（逗号分隔或重复传入）。 |
--provider 供应商 |
覆盖推理供应商。 |
-v, --verbose |
输出详细信息。 |
-Q, --quiet |
程序化使用的安静模式（隐藏 banner、spinner、工具预览）。 |
--resume 会话ID, -r 会话ID |
按 ID 恢复之前的会话。 |
--no-restore-cwd |
恢复会话时不切换到其记录的工作目录。 |
--continue [会话名], -c [会话名] |
按名称恢复会话，省略时恢复最近会话。 |
--worktree, -w |
在隔离的 git worktree 中运行（用于并行 Agent）。 |
--accept-hooks |
自动批准未见过 shell 钩子，无需提示。 |
--checkpoints |
在破坏性文件操作前启用文件系统检查点。 |
--max-turns N |
每轮对话最大工具调用迭代次数（默认 500 或 agent.max_turns）。 |
--yolo |
跳过所有危险命令审批提示。 |
--pass-session-id |
在系统提示中包含会话 ID。 |
--ignore-user-config |
忽略 ~/.hermes/config.yaml，使用内置默认值。 |
--ignore-rules |
跳过 AGENTS.md、SOUL.md、记忆注入和预加载技能。 |
--safe-mode |
禁用所有自定义配置（配置、规则、插件、MCP 服务器）。 |
--source 来源 |
会话来源标签（默认：cli）。 |
--tui |
启动现代 TUI。 |
--cli |
强制使用经典 prompt_toolkit REPL。 |
--dev |
与 --tui 一起使用：通过 tsx 运行 TypeScript 源码。 |
示例
# 交互式会话
hermes chat
# 单次查询
hermes chat -q "解释项目结构"
# 指定模型和工具集
hermes chat -q "重构认证模块" -m anthropic/claude-sonnet-4 -t file,terminal
# 附加图片
hermes chat --image ~/screenshot.png -q "描述这个界面"
# 恢复最近的会话
hermes chat -c
# 按名称恢复会话
hermes chat -c "调试会话"
# 预加载技能并在隔离 worktree 中运行
hermes chat -s git-workflow,code-review --worktree
# 启用检查点并跳过审批，用于自动化
hermes chat --checkpoints --yolo -q "运行完整测试套件"
# 安静的程序化输出
hermes chat -Q -q "仅返回文件列表"
# 排错：完全隔离运行
hermes chat --safe-mode提示
- 在管道或脚本中使用
-Q，输出仅包含最终回复和会话信息。 - 运行破坏性文件操作时使用
--checkpoints，可通过/rollback恢复。 - 使用
--reasoning提高或降低单次会话的推理强度。 --safe-mode是验证问题是否由配置、规则或插件引起的最快方式。
另请参阅
hermes、hermes model、hermes sessions、hermes tools、会话中的 /help。