harahara
CLI 参考交互模式

交互模式

hara REPL —— 斜杠命令、附加文件、引导正在运行的任务,以及管理上下文。

不带任何参数运行 hara 打开 REPL:一个固定在底部的输入框、流式输出,以及彩色 diff。 (HARA_TUI=0 会退回到经典的 readline 提示符。)

正文下方的界面是恒定高度的:一行状态槽在任务运行时显示 spinner + 当前步骤、空闲时显示 快捷键提示,所以输入框在回合起止时不会上下跳。按 shift+tab,同一槽位会换成单行模式选择器 (suggest → auto-edit → full-auto → plan——各模式的行为(包括 plan 模式的 exit_plan 握手) 见权限与安全)。

引导与附加

  • 在它工作时直接输入。 回合进行中发送的消息会在工具调用间隙到达模型并被分诊: 当前任务的补充 → 立即融入;新的独立任务 → 挂上 todo 队列(当前工作继续); 紧急输入("停"/"先做这个")→ 安全收尾当前步骤后立即切换。
  • @path 把某个文件的内容内联附加进来(Tab 补全;@dir/ 列出目录)。

斜杠命令

输入 / 即可看到它们。最常用的:

命令作用
/model [id]显示或切换模型
/approval [mode]循环或设置批准模式(suggest · auto-edit · full-auto)
/tools · /usage · /context列出工具 · token 用量 · 是什么在占满窗口
/org <task> · /plan <task>派发给某角色 · 作为原子任务规划并执行
/roles · /skills · /skill <id>列出角色 · 列出技能 · 把某技能加载进你的下一条消息
/diff [staged] · /review · /commit工作区 diff · 评审 bug/安全 · AI 提交
/undo撤销本会话最近一次文件改动
/rewind [n]把对话分叉回到更早的回合(文件不动)
/checkpoint [restore n]列出 / 恢复一个文件状态快照
/compact总结对话以释放上下文
/recall <query>从代码资产库拉取片段进上下文
/sessions · /name <name>列出已保存的会话 · 重命名当前会话
/vision <model>设置一个描述模型,让纯文本模型也能读图
/init · /doctor重新生成 AGENTS.md · 检查环境
/reset · /exit清空上下文 · 退出

关于 /rewind/checkpoint/compact 如何与 hara 的持久化模型关联, 见 记忆与会话

Was this helpful?
harahara
A product by Nanhara · Apache-2.0 · v0.139.0

© 2026 Nanhara Technologies