不带任何参数运行 hara 进入交互式 REPL,或用子命令做一次性工作。hara --help
列出全部命令;hara <command> --help 深入查看某条命令。
全局选项
这些选项适用于大多数命令:
| 选项 | 作用 |
|---|
-p, --print <prompt> | 非交互(无界面)地运行一条 prompt |
-y, --yes | 自动批准每一个工具动作(= --approval full-auto) |
-m, --model <model> | 为本次运行覆盖模型 |
--approval <mode> | suggest · auto-edit · full-auto |
--profile <name> | 使用某个命名 profile |
-c, --continue | 恢复此目录下最近的会话 |
--resume <id> | 恢复指定会话 |
--sandbox <mode> | off · workspace-write · read-only(macOS) |
核心命令
| 命令 | 作用 |
|---|
hara | 交互式 REPL(见 交互模式) |
hara setup | 首次运行向导:供应商 → 端点 → key → 模型 |
hara init | 分析项目并写入 / 刷新 AGENTS.md |
hara doctor | 检查供应商、鉴权、模型、角色、技能、记忆、搜索、MCP… |
hara -p "<task>" | 无界面运行单个任务 |
组织与规划
| 命令 | 作用 |
|---|
hara org <task> | 把任务路由到拥有它的角色 |
hara org <task> --review | 让 reviewer 循环评审直到 diff 干净(--rounds <n>,默认 3) |
hara org <task> --review --commit | 批准后用 AI 生成的信息提交 |
hara org <task> --role <id> | 强制使用指定角色 |
hara plan [task] | 分解为原子任务,按 DAG 排序,逐个 verify |
hara plan --parallel | 并发运行相互独立的原子任务 |
hara plan resume | 继续一个被停止的计划 |
关于角色、评审链与计划如何协同,见 组织模型。
代码:评审与提交
| 命令 | 作用 |
|---|
hara review | 评审未提交的改动,查找 bug / 安全问题 / 缺失的测试 |
hara review --staged | 只评审已暂存的改动 |
hara review --base <ref> | 对某个基准 ref(如 main)做评审 |
hara commit | 根据暂存改动写一条提交信息并提交 |
hara commit -a | 先暂存所有被跟踪的改动 |
搜索与资产
| 命令 | 作用 |
|---|
hara recall [query] | 在你的代码资产库里搜索片段 / playbook(--init 可脚手架) |
hara index | 构建语义索引 —— --repo(代码搜索)、--assets 或 --all(需要嵌入供应商) |
管理你的组织
| 命令 | 作用 |
|---|
hara roles | 列出角色(hara roles init 脚手架生成 implementer / reviewer / docs) |
hara skills | 列出技能(hara skills init 脚手架生成一个)—— 见 技能与插件 |
hara plugin | 列出插件(add / remove / enable / disable) |
hara memory | show · init · distill —— 见 记忆与会话 |
hara cron | 定时任务 —— 见 定时任务 |
hara config | set · get · path —— 见 配置 |
hara permissions | 显示 / 脚手架生成 bash 命令规则(--init、--project) |
会话与集成
| 命令 | 作用 |
|---|
hara sessions | 列出已保存的会话 |
hara export [session] | 把一个会话渲染成 Markdown(--out <file>) |
hara gateway | 运行聊天网关 —— 见 渠道与网关 |
hara mcp | 把 hara 作为 MCP 服务器运行(stdio)—— 向其他客户端暴露读取 / 搜索工具 |
hara completions <shell> | 打印 shell 补全:bash · zsh · fish |
hara login qwen | Qwen OAuth 设备登录(免费额度) |
hara enroll [url] --code <c> | 用注册码加入一个 fleet |
