Harness CLI (AIOS)¶
Harness CLI 是一个本地优先的 Agent 工作流层。它保留你已经在使用的 codex、claude、gemini、opencode、hermes 或 grok（Grok Build），再补上跨会话项目记忆、并行协作、可恢复运行和验证门禁。
开始快速安装 按场景选择 查看工作流策略 阅读博客 GitHub
一句话回答¶
如果你需要让 Agent 在不同会话和不同客户端之间共享项目事实、把独立工作交给多个 Agent，或让长任务能够暂停后继续，Harness CLI 提供了这些能力的本地工作流层。它不会替换底层编码客户端，也不会把所有历史自动塞进每个提示。
核心能力¶
| 能力 | 作用 | 起点 |
|---|---|---|
| ContextDB | 按需读取的项目记忆、memo、检查点和上下文包 | aios init / ContextDB |
| Workflow Policy | 用 noop、direct、guarded、planned 选择风险匹配的路径 | 工作流策略 |
| Agent Team | 有治理和 HUD 证据的独立任务并行协作 | aios team / Agent Team |
| Solo Harness | 带运行日志和恢复入口的长任务 | aios harness run / Solo Harness |
| RTK / Caveman | 分别处理本地输出噪声和响应表达长度 | Token Intelligence |
| Headroom MCP | 通过支持的 MCP 客户端显式压缩和取回内容 | Token Intelligence |
| Verification / Privacy | 诊断、测试、质量门禁和敏感内容脱敏 | 故障排查 |
现在就做¶
# 在项目根目录初始化客户端指引和项目标记。
aios init --all
# 查看原生同步、运行时和安全检查结果。
aios doctor --native --verbose
项目标记指向 .aios/context-db/index.json。ContextDB 使用 pull-based 读取：Agent 需要时搜索相关资料，而不是每次启动都读取完整历史。
选择正确路径¶
| 你的目标 | 推荐入口 |
|---|---|
| 先问一个问题或查看资料 | Workflow Policy 的 direct |
| 做一个小而清晰的本地改动 | guarded + Verification |
| 多步骤、跨文件或需要恢复的工作 | planned / Solo Harness |
| 两个以上互不依赖的工作包 | Agent Team |
| 阶段性编排和质量证据 | Use Cases |
运行时边界¶
用户
-> codex / claude / gemini / opencode / hermes / grok
-> native guidance + .aios/context-db/index.json
-> ContextDB 按需搜索 / memo / checkpoint
-> Team、Solo Harness、Orchestrate（按任务需要）
-> browser-use CDP（浏览器任务需要时）
Playwright MCP 保留为兼容路径；当前浏览器文档默认使用 browser-use CDP。RTK、Caveman 和 Headroom MCP 也各有独立的安装、授权和验证边界。
第一次使用¶
- 阅读 快速开始，执行 aios init --all。
- 执行 aios doctor --native --verbose，根据证据处理警告。
- 在项目中启动一个支持的客户端。
- 需要长期记忆时阅读 ContextDB，需要选择路径时阅读 工作流策略。
相关入口¶
- Windows 指南 - PowerShell 安装和恢复。
- 架构 - 运行时层和兼容性边界。
- 案例库 - 可复现的跨客户端、浏览器和隐私案例。
- 友情链接 - 生态和相关项目。
- 博客 - 工作流教程、版本说明和技术深挖。