CLI 界面

Hermes Agent 的 CLI 是一个完整的终端用户界面（TUI）— 而不是 Web UI。它具有多行编辑、斜杠命令自动补全、对话历史、中断和重定向，以及流式工具输出。为生活在终端中的人构建。

运行 CLI

# 启动交互式会话（默认）
hermes

# 单查询模式（非交互式）
hermes chat -q "Hello"

# 使用特定模型
hermes chat --model "anthropic/claude-sonnet-4"

# 使用特定 provider
hermes chat --provider nous        # 使用 Nous Portal
hermes chat --provider openrouter  # 强制 OpenRouter

# 使用特定工具集
hermes chat --toolsets "web,terminal,skills"

# 启动时预加载一个或多个 skills
hermes -s hermes-agent-dev,github-auth
hermes chat -s github-pr-workflow -q "open a draft PR"

# 恢复之前的会话
hermes --continue             # 恢复最近的 CLI 会话（-c）
hermes --resume <session_id>  # 按 ID 恢复特定会话（-r）

# 详细模式（调试输出）
hermes chat --verbose

# 隔离的 git worktree（用于并行运行多个 agent）
hermes -w                         # 在 worktree 中的交互模式
hermes -w -q "Fix issue #123"     # 在 worktree 中的单个查询

界面布局

Hermes CLI 横幅、对话流和固定输入提示，渲染为稳定的文档图形而非脆弱的文本艺术。

欢迎横幅一目了然地显示您的模型、终端后端、工作目录、可用工具和已安装的 skills。

状态栏

一个持久的状态栏位于输入区域上方，实时更新：

 ⚕ claude-sonnet-4-20250514 │ 12.4K/200K │ [██████░░░░] 6% │ $0.06 │ 15m

元素	描述
模型名称	当前模型（如果超过 26 个字符则截断）
Token 计数	使用的上下文 token / 最大上下文窗口
上下文条	带颜色编码阈值的可视化填充指示器
成本	估计的会话成本（或 `n/a` 用于未知/零价模型）
时长	经过的会话时间

该条形图适应终端宽度 — 宽度 ≥ 76 列时完整布局，52–75 列时紧凑，52 列以下时最小（仅模型和时长）。

上下文颜色编码：

颜色	阈值	含义
绿色	< 50%	空间充足
黄色	50–80%	逐渐填满
橙色	80–95%	接近限制
红色	≥ 95%	接近溢出 — 考虑 `/compress`

使用 /usage 获取详细的分类成本细分（输入 vs 输出 token）。

会话恢复显示

恢复之前的会话时（hermes -c 或 hermes --resume <id>），横幅和输入提示之间会出现"上一对话"面板，显示对话历史的紧凑摘要。请参阅 Sessions — 恢复时的对话摘要了解详细信息和配置。

按键绑定

键	动作
`Enter`	发送消息
`Alt+Enter` 或 `Ctrl+J`	新行（多行输入）
`Alt+V`	当终端支持时，从剪贴板粘贴图像
`Ctrl+V`	粘贴文本并有条件地附加剪贴板图像
`Ctrl+B`	启用语音模式时开始/停止语音录制（`voice.record_key`，默认：`ctrl+b`）
`Ctrl+C`	中断 agent（2 秒内第二次按强制退出）
`Ctrl+D`	退出
`Ctrl+Z`	将 Hermes 挂起到后台（仅 Unix）。在 shell 中运行 `fg` 恢复。
`Tab`	接受自动建议（幽灵文本）或自动补全斜杠命令

斜杠命令

输入 / 查看自动补全下拉菜单。Hermes 支持大量内置 CLI 斜杠命令、动态 skill 命令和用户定义的快速命令。

常见示例：

命令	描述
`/help`	显示命令帮助
`/model`	显示或更改当前模型
`/tools`	列出当前可用的工具
`/skills browse`	浏览 skills hub 和官方可选 skills
`/background <prompt>`	在单独的后台会话中运行提示
`/skin`	显示或切换活动 CLI 皮肤
`/voice on`	启用 CLI 语音模式（按 `Ctrl+B` 录制）
`/voice tts`	切换 Hermes 回复的语音播放
`/reasoning high`	提高推理努力
`/title My Session`	为当前会话命名

有关完整的内置 CLI 和消息列表，请参阅 Slash Commands Reference。

有关设置、provider、静音调优和消息/Discord 语音用法，请参阅 Voice Mode。

提示

命令不区分大小写 — /HELP 与 /help 相同。已安装的 skills 也会自动成为斜杠命令。

快速命令

您可以定义在调用 LLM 时立即运行 shell 命令的自定义命令。这些在 CLI 和消息平台（Telegram、Discord 等）中都有效。

# ~/.hermes/config.yaml
quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent
  gpu:
    type: exec
    command: nvidia-smi --query-gpu=utilization.gpu,memory.used --format=csv,noheader

然后在任何聊天中输入 /status 或 /gpu。请参阅 Configuration guide 获取更多示例。

启动时预加载 Skills

如果您已经知道会话需要哪些 skills，请在启动时传递它们：

hermes -s hermes-agent-dev,github-auth
hermes chat -s github-pr-workflow -s github-auth

Hermes 在第一次轮次之前将每个命名的 skill 加载到会话提示中。相同的标志在交互模式和单查询模式下都有效。

Skill 斜杠命令

~/.hermes/skills/ 中的每个已安装 skill 都会自动注册为斜杠命令。skill 名称成为命令：

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor

# 仅 skill 名称会加载它并让 agent 询问您需要什么：
/excalidraw

人格

设置预定义人格以更改 agent 的语气：

/personality pirate
/personality kawaii
/personality concise

内置人格包括：helpful、concise、technical、creative、teacher、kawaii、catgirl、pirate、shakespeare、surfer、noir、uwu、philosopher、hype。

您也可以在 ~/.hermes/config.yaml 中定义自定义人格：

personalities:
  helpful: "You are a helpful, friendly AI assistant."
  kawaii: "You are a kawaii assistant! Use cute expressions..."
  pirate: "Arrr! Ye be talkin' to Captain Hermes..."
  # 添加您自己的！

多行输入

有两种方式输入多行消息：

Alt+Enter 或 Ctrl+J — 插入新行
反斜杠继续 — 以 \ 结束一行以继续：

❯ Write a function that:\
  1. Takes a list of numbers\
  2. Returns the sum

信息

支持粘贴多行文本 — 使用 Alt+Enter 或 Ctrl+J 插入换行符，或直接粘贴内容。

中断 Agent

您可以随时中断 agent：

在 agent 工作时输入新消息 + Enter — 它会中断并处理您的新指令
Ctrl+C — 中断当前操作（2 秒内第二次按强制退出）
进行中的终端命令会立即终止（SIGTERM，然后 1 秒后 SIGKILL）
在中断期间输入的多个消息会合并为一个提示：

忙碌输入模式

display.busy_input_mode 配置键控制在 agent 工作时按 Enter 会发生什么：

模式	行为
`"interrupt"`（默认）	您的消息中断当前操作并立即处理
`"queue"`	您的消息被静默排队，并在 agent 完成后作为下一轮发送

# ~/.hermes/config.yaml
display:
  busy_input_mode: "queue"   # 或 "interrupt"（默认）

队列模式在您想准备后续消息而不意外取消进行中的工作时很有用。未知值回退到 "interrupt"。

挂起到后台

在 Unix 系统上，按 Ctrl+Z 将 Hermes 挂起到后台 — 就像任何终端进程一样。shell 打印确认：

Hermes Agent has been suspended. Run `fg` to bring Hermes Agent back.

在 shell 中输入 fg 以 exactly 恢复会话状态。这在 Windows 上不支持。

工具进度显示

CLI 在 agent 工作时显示动画反馈：

思考动画（API 调用期间）：

  ◜ (｡•́︿•̀｡) pondering... (1.2s)
  ◠ (⊙_⊙) contemplating... (2.4s)
  ✧٩(ˊᗜˋ*)و✧ got it! (3.1s)

工具执行提要：

  ┊ 💻 terminal `ls -la` (0.3s)
  ┊ 🔍 web_search (1.2s)
  ┊ 📄 web_extract (2.1s)

使用 /verbose 循环切换显示模式：off → new → all → verbose。此命令也可以为消息平台启用 — 请参阅 configuration。

工具预览长度

display.tool_preview_length 配置键控制工具调用预览行中显示的最大字符数（例如文件路径、终端命令）。默认为 0，表示无限制 — 显示完整路径和命令。

# ~/.hermes/config.yaml
display:
  tool_preview_length: 80   # 将工具预览截断为 80 个字符（0 = 无限制）

这在窄终端上或当工具参数包含非常长的文件路径时很有用。

会话管理

恢复会话

退出 CLI 会话时，会打印恢复命令：

Resume this session with:
  hermes --resume 20260225_143052_a1b2c3

Session:        20260225_143052_a1b2c3
Duration:       12m 34s
Messages:       28 (5 user, 18 tool calls)

恢复选项：

hermes --continue                          # 恢复最近的 CLI 会话
hermes -c                                  # 短格式
hermes -c "my project"                     # 恢复命名会话（血统中最新的）
hermes --resume 20260225_143052_a1b2c3     # 按 ID 恢复特定会话
hermes --resume "refactoring auth"         # 按标题恢复
hermes -r 20260225_143052_a1b2c3           # 短格式

恢复从 SQLite 恢复完整对话历史。agent 会看到所有先前的消息、工具调用和响应 — 就像您从未离开过一样。

使用 /title My Session Name 在聊天中为当前会话命名，或从命令行使用 hermes sessions rename <id> <title>。使用 hermes sessions list 浏览过去的会话。

会话存储

CLI 会话存储在 Hermes 的 SQLite 状态数据库 ~/.hermes/state.db 中。数据库保存：

会话元数据（ID、标题、时间戳、token 计数器）
消息历史
压缩/恢复会话的血统
session_search 使用的全文搜索索引

某些消息适配器也在数据库旁边保留每个平台的转录文件，但 CLI 本身从 SQLite 会话存储恢复。

上下文压缩

长对话在接近上下文限制时自动总结：

# 在 ~/.hermes/config.yaml 中
compression:
  enabled: true
  threshold: 0.50    # 默认在上下文限制的 50% 处压缩

# 在 auxiliary 下配置的摘要模型：
auxiliary:
  compression:
    model: "google/gemini-3-flash-preview"  # 用于摘要的模型

当压缩触发时，中间轮次被总结，而前 3 轮和后 4 轮始终保留。

后台会话

在单独的后台会话中运行提示，同时继续使用 CLI 进行其他工作：

/background Analyze the logs in /var/log and summarize any errors from today

Hermes 立即确认任务并给您回提示：

🔄 Background task #1 started: "Analyze the logs in /var/log and summarize..."
   Task ID: bg_143022_a1b2c3

工作原理

每个 /background 提示在守护线程中生成一个完全独立的 agent 会话：

隔离对话 — 后台 agent 不了解您当前会话的历史。它仅接收您提供的提示。
相同配置 — 后台 agent 从当前会话继承您的模型、provider、工具集、推理设置和回退模型。
非阻塞 — 您的前台会话保持完全交互。您可以聊天、运行命令，甚至启动更多后台任务。
多个任务 — 您可以同时运行多个后台任务。每个任务获得一个编号 ID。

结果

当后台任务完成时，结果会作为面板出现在您的终端中：

╭─ ⚕ Hermes (background #1) ──────────────────────────────────╮
│ Found 3 errors in syslog from today:                         │
│ 1. OOM killer invoked at 03:22 — killed process nginx        │
│ 2. Disk I/O error on /dev/sda1 at 07:15                      │
│ 3. Failed SSH login attempts from 192.168.1.50 at 14:30      │
╰──────────────────────────────────────────────────────────────╯

如果任务失败，您会看到错误通知。如果在配置中启用了 display.bell_on_complete，任务完成时会响起终端铃声。

用例

长时间运行的研究 — "/background research the latest developments in quantum error correction" 而您处理代码
文件处理 — "/background analyze all Python files in this repo and list any security issues" 而您继续对话
并行调查 — 启动多个后台任务同时探索不同角度

信息

后台会话不会出现在您的主要对话历史中。它们是具有自己任务 ID（例如 bg_143022_a1b2c3）的独立会话。

安静模式

默认情况下，CLI 以安静模式运行：

禁止工具的详细日志
启用 kawaii 风格的动画反馈
保持输出简洁和用户友好

获取调试输出：

hermes chat --verbose

运行 CLI​

界面布局​

状态栏​

会话恢复显示​

按键绑定​

斜杠命令​

快速命令​

启动时预加载 Skills​

Skill 斜杠命令​

人格​

多行输入​

中断 Agent​

忙碌输入模式​

挂起到后台​

工具进度显示​

工具预览长度​

会话管理​

恢复会话​

会话存储​

上下文压缩​

后台会话​

工作原理​

结果​

用例​

安静模式​