Hermes harness 用于从宿主智能体驱动 Nous Hermes Agent CLI(hermes),避免使用 TUI。经验证对应 Hermes Agent v0.20.0(原生 Windows、官方安装器),若参数过时需重新查看 hermes --help。
用途:让宿主智能体以脚本方式调用 hermes,完成一次性提问、会话续接与工具调用。不要自行编造 terminal()/process() 之类 API,直接调用 hermes。
安装(Windows):iex (irm https://hermes-agent.nousresearch.com/install.ps1)。安装位于 %LOCALAPPDATA%\hermes(含 config.yaml、.env、hermes-agent 检出与 venv)。WSL/Linux 使用 ~/.hermes,命令为 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash。刷新 PATH 后执行 hermes --version;用 hermes setup 或 hermes model 选择提供方。配置路径可用 hermes config path 查询,勿提交 .env 与 auth.json。
一次性驱动有两种脚本模式:hermes -z "…" 只输出最终文本,会话 id 隐藏但仍保存,审批自动跳过;hermes chat -q "…" -Q 输出最终文本,session_id 打印在 stderr,使用工具需加 --yolo。示例:hermes -z "Respond with exactly: HERMES_SMOKE_OK";hermes chat -q "Respond with exactly: HERMES_CHAT_OK" -Q。历史按当前工作目录记录,故先 cd。恢复方式:--resume <session_id> 或 -c 续接最近会话;会话 id 形如 20260815_040545_f2d37d,可用 hermes sessions list --workspace <dir> --limit 10 列出。
常用参数:-z/--oneshot;chat -q/--query;-Q/--quiet 抑制横幅与动画但保留 session_id;--resume/-r;-c/--continue;-m/--model 覆盖模型;--provider 覆盖提供方;--yolo 跳过危险命令确认;--accept-hooks 自动批准未见过钩子;--skills/-s 预加载技能;--ignore-rules 跳过 AGENTS.md、记忆与预加载技能;--usage-file 在 -z 后写 JSON 用量。注意 -Q 在写文件时仍会打印文件差异预览。
TUI/REPL:hermes 为默认界面,hermes --tui 或 hermes --cli 为经典 REPL,仅在真实 PTY 下使用;裸 hermes 在非 PTY 会挂起。
ACP/MCP:hermes acp --check 检查、hermes acp 提供编辑器用 ACP stdio、hermes mcp serve 作为 MCP 服务器、hermes mcp list 列表;未经要求不要添加 MCP 服务器或插件。其他命令包括 hermes status、doctor、model、auth list、config path、sessions list、update、gateway(消息网关见 buzz-hermes-gateway)。
限制与陷阱:Windows 家目录是 %LOCALAPPDATA%\hermes 而非 ~/.hermes;-z 不打印 session_id;--yolo 仅用于 chat/TUI;宿主为 PowerShell 时不要在双引号字符串中使用 Linux 的 2>/dev/null;卸载/转发见 harness-offload,其调度器通过 System.Diagnostics.Process 运行 Hermes,避免 stderr 的 session_id 被当成 PowerShell 错误。