https://github.com/rexleimo/harness-cli
Local-first AI agent bootstrap: Playwright Browser MCP + ContextDB for Codex CLI, Claude Code, Gemini CLI, and OpenCode.
https://github.com/rexleimo/harness-cli
ai-agent automation browser-automation claude-code cli codex-cli contextdb gemini-cli local-first mcp opencode playwright typescript
Last synced: 11 days ago
JSON representation
Local-first AI agent bootstrap: Playwright Browser MCP + ContextDB for Codex CLI, Claude Code, Gemini CLI, and OpenCode.
- Host: GitHub
- URL: https://github.com/rexleimo/harness-cli
- Owner: rexleimo
- Created: 2026-03-01T06:24:09.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-06-01T06:05:28.000Z (19 days ago)
- Last Synced: 2026-06-01T07:21:48.798Z (19 days ago)
- Topics: ai-agent, automation, browser-automation, claude-code, cli, codex-cli, contextdb, gemini-cli, local-first, mcp, opencode, playwright, typescript
- Language: JavaScript
- Homepage: https://cli.rexai.top/
- Size: 12.3 MB
- Stars: 42
- Watchers: 0
- Forks: 6
- Open Issues: 16
-
Metadata Files:
- Readme: README-zh.md
- Changelog: CHANGELOG.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Harness CLI (AIOS)
> 给 `codex` / `claude` / `gemini` / `opencode` / `antigravity` / `crush` 加上记忆、协作和验证能力的本地 Agent 工作流层。
[文档站](https://cli.rexai.top) | [快速开始](https://cli.rexai.top/zh/getting-started/) | [官方案例库](https://cli.rexai.top/zh/case-library/) | [GitHub](https://github.com/rexleimo/harness-cli)
## 安装
macOS / Linux:
```bash
curl -fsSL https://github.com/rexleimo/harness-cli/releases/latest/download/aios-install.sh | bash
source ~/.zshrc
aios
```
Windows PowerShell:
```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; irm https://github.com/rexleimo/harness-cli/releases/latest/download/aios-install.ps1 | iex
. $PROFILE
aios
```
启动后选择 `Setup`，运行 `Doctor`，即可开始使用。
## 核心能力
| 能力 | 说明 | 命令 |
|------|------|------|
| **ContextDB** | 跨会话项目记忆，事件/检查点/上下文包持久化 | `codex` / `claude` / `gemini` / `opencode` / `antigravity` / `crush` 自动加载 |
| **Memo Storage** | 适合 Git 共享的项目 memo；默认 append-only file 存储，也可切到 split 文件存储 | `aios memo add "note"` / `aios memo storage status` |
| **原生路由快捷命令** | 在客户端内直接触发 single/subagent/team/harness 通道 | Claude/Gemini/OpenCode: `/team <任务>`；Codex: `/prompts:team <任务>` |
| **原生 Token 压缩** | 自研输入/输出 token 压缩，参考 RTK/Caveman 思路，但不安装竞品工具 | `context:pack --token-budget 1200 --token-strategy balanced` |
| **Model Router** | Agent Team 智能多模型调度 — 按能力、成本、成功率匹配最优模型 | `node scripts/aios.mjs model-router route --task "..."` |
| **Agent Team** | 多 Agent 并行协作，HUD 可视化追踪 | `aios team 3:codex "任务描述"` |
| **Solo Harness** | 单 Agent 过夜长任务，可恢复、有运行日志 | `aios harness run --objective "目标" --worktree` |
| **Perception** | 内容结果追踪 + 统计洞察 + 感知注入 | `aios perception record` / `insights` / `summary` |
| **Browser MCP** | 隐身浏览器自动化，CDP 协议 | `aios internal browser doctor` |
| **Superpowers** | 可复用工作流技能（brainstorm/plan/debug/verify） | TUI 中选择 |
| **Privacy Guard** | 敏感文件读取前自动脱敏 | `aios privacy status` |
## 快速体验
```bash
# 启动 TUI
aios
# 保存适合 Git 共享的项目 memo
aios memo add "记住 auth 测试要保持严格"
aios memo storage status
# 在原生客户端内路由任务（setup 后）
# Claude/Gemini/OpenCode: /team <任务>
# Codex: /prompts:team <任务>
# 多 Agent 协作
aios team 3:codex "重构登录模块并运行测试"
# 智能模型路由
node scripts/aios.mjs model-router route --task "审查 auth.js 安全漏洞"
# 自研 token 压缩 ContextDB 包
cd mcp-server && npm run contextdb -- context:pack --session --token-budget 1200 --token-strategy balanced
# 单 Agent 过夜任务
aios harness run --objective "完成明天的交接文档" --worktree
# 内容结果追踪（小红书等场景）
aios perception record --content-id note_001 --platform xiaohongshu --content-type note --title "测试" --metrics '{"likes":100}'
# 查看任务状态
aios team status --provider codex --watch
```
## 工作原理
```text
用户 → codex / claude / gemini / opencode / antigravity / crush
→ zsh wrapper（透明包装）
→ ctx-agent.mjs（ContextDB 集成）
→ contextdb CLI（记忆持久化）
→ 启动原生 CLI（附带上下文包）
→ browser MCP（可选浏览器自动化）
```
安装后，直接使用 `codex`、`claude`、`gemini`、`opencode`、`antigravity` 或 `crush` 命令即可，Harness CLI 自动在后台加载项目记忆，并在客户端支持时安装路由快捷命令。
## 文档
- [快速开始](https://cli.rexai.top/zh/getting-started/) — 安装、配置、首次运行
- [Model Router](https://cli.rexai.top/zh/model-router/) — Agent Team 多模型智能调度
- [ContextDB](https://cli.rexai.top/zh/contextdb/) — 项目记忆系统详解
- [Agent Team](https://cli.rexai.top/zh/team-ops/) — 多 Agent 协作指南
- [Solo Harness](https://cli.rexai.top/zh/solo-harness/) — 过夜长任务指南
- [Perception](https://cli.rexai.top/zh/perception/) — 内容结果追踪与洞察
- [架构](https://cli.rexai.top/zh/architecture/) — 系统架构说明
- [故障排查](https://cli.rexai.top/zh/troubleshooting/) — 常见问题解决
- [按场景找命令](https://cli.rexai.top/zh/use-cases/) — CLI 工作流速查
## 环境要求
- Git
- Node.js 24 LTS + npm
- Windows: PowerShell 5.x 或 7
## 开发
```bash
git clone https://github.com/rexleimo/harness-cli.git
cd harness-cli
```
验证:
```bash
cd mcp-server
npm test
npm run typecheck
npm run build
```
## 许可
详见 [CHANGELOG.md](CHANGELOG.md) 版本历史。