原生 CLI vs Harness CLI 层¶
快速答案： 一次性、低风险的小任务可以直接使用
codex、claude、gemini或opencode。当任务需要跨会话记忆、工作流路由、多客户端交接、浏览器安全或验证证据时，再加上 Harness CLI。它是本地工作流能力层，不会替换你的 coding agent。
先看决策¶
| 需求 | 推荐路径 |
|---|---|
| 没有持久状态的短任务 | 原生 CLI |
| 共享项目记忆和可检索上下文 | Harness CLI + ContextDB |
| 多客户端或多 Agent 协作 | Harness CLI + Agent Team |
| 需要安全门禁和完成证据的修改 | Harness CLI + 编辑/验证门禁 |
Harness CLI 不是 Codex、Claude 或 Gemini CLI 的替代品。 它是它们之上的可靠性层。
Harness CLI 改变了什么¶
| 工作流需求 | 仅用原生 CLI | 使用 Harness CLI 层 |
|---|---|---|
| 跨会话记忆 | 手动复制粘贴上下文 | 项目 ContextDB 默认恢复 |
| 跨 agent 接力 | 临时且脆弱 | 共享 session/checkpoint 工件 |
| 浏览器自动化 | 工具逐一配置漂移 | 统一 MCP 安装 + doctor 脚本 |
| 敏感配置读取安全 | 容易将密钥泄露到 prompts | Privacy Guard 脱敏路径 |
| 操作恢复 | 手动排查 | Doctor 脚本 + 可复现 runbook |
何时仅用原生 CLI¶
- 你需要一个没有接力的临时短任务。
- 你不需要会话持久性或工作流可追溯性。
- 你在一次性环境中实验。
何时添加 Harness CLI¶
- 你在同一个项目中切换使用
codex、claude、gemini或opencode。 - 你需要重启安全的上下文和可审计的 checkpoint。
- 你需要浏览器自动化和认证墙处理，且有明确的人工交接。
- 你必须减少配置读取期间的意外密钥暴露。
快速验证（5 分钟）¶
git clone https://github.com/rexleimo/harness-cli.git
cd harness-cli
scripts/setup-all.sh --components all --mode opt-in
source ~/.zshrc
codex
然后验证持久化工件存在：
ls .aios/context-db
预期结果：sessions/、index/、exports/。
深度案例¶
下一步¶
常见问题¶
Harness CLI 会替换我的 coding agent 吗？¶
不会。它在支持的客户端外层提供本地工作流、记忆和验证能力。
什么时候原生 CLI 更合适？¶
任务小、无状态、低风险，并且额外的项目上下文不会改善结果时，直接使用原生 CLI 更简单。