CLI(命令行界面)是 Hermes Agent 最原生的交互方式,也是功能最完整的使用入口。
本章将系统介绍 CLI 的三种运行模式、会话管理、斜杠命令、TUI 界面、快捷操作以及脚本化使用技巧。
三种运行模式
Hermes CLI 提供三种运行模式,从简单问答到交互式会话再到纯键盘操作,覆盖不同使用场景。
模式一:交互式会话(hermes chat)
这是最常用的模式——启动一个持续的多轮对话会话。
启动交互式会话(使用默认 Profile):
hermes chat
启动后进入对话界面,提示符变为,输入消息后按 Enter 发送,Agent 开始回复:
进入交互式会话后,你可以连续发送多条消息,Agent 会记住前面的对话上下文。
这是日常开发中最自然的使用方式——就像和一个同事在 Slack 上聊天一样。
模式二:一次性查询(-q / --query)
不需要进入交互式会话,直接传入问题并获得回复,适合脚本化和快速查询。
实例
-q 模式的关键特性:
模式三:TUI 终端界面(hermes --tui)
TUI(Terminal User Interface)提供纯键盘操作的全屏终端界面。
TUI 模式的独特优势:
三种模式对比
会话管理
会话(Session)是 CLI 中对话的基本单位。每个会话拥有独立的上下文、Token 计数和会话 ID。
继续与恢复会话
恢复会话时,Agent 保留完整的对话上下文,包括之前的工具调用记录和 LLM 推理历史。
开启新会话
新会话不保留之前的对话上下文,但持久记忆(MEMORY.md 和 USER.md)仍然可见。
会话标题管理
Hermes 会在第一轮对话后自动生成会话标题,你也可以手动命名:
上下文压缩
当对话历史过长、接近上下文窗口上限时,可以手动触发压缩:
自动压缩由 Hermes 在上下文接近上限时自动触发。/compress 只是让你可以手动提前触发。两者效果相同。
常用斜杠命令
在交互式会话和 TUI 模式中,以 / 开头的输入被识别为斜杠命令。
以下是 CLI 中最常用的命令,按功能分组。
会话控制
任务控制
/undo 是对话级别的撤销——它会从会话历史中删除最后一轮问答,Agent 的上下文回到上一次回复之前的状态。这不同于 /retry(保留原问答,让 Agent 重新回答)。