Harness CLI (AIOS)
A local agent workflow layer that adds memory, collaboration, and verification to
codex/claude/gemini/opencode/antigravity/crush.
Docs | Quick Start | Case Library | GitHub
Install
macOS / Linux:
curl -fsSL https://github.com/rexleimo/harness-cli/releases/latest/download/aios-install.sh | bash
source ~/.zshrc
aios
Windows PowerShell:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; irm https://github.com/rexleimo/harness-cli/releases/latest/download/aios-install.ps1 | iex
. $PROFILE
aios
Once started, select Setup, run Doctor, and you're ready to go.
Core Capabilities
| Capability | Description | Command |
|---|---|---|
| ContextDB | Cross-session project memory with events, checkpoints, and context packs | auto-loaded by codex / claude / gemini / opencode / antigravity / crush |
| Memo Storage | Git-friendly project notes; default append-only file storage plus optional split-file storage | aios memo add "note" / aios memo storage status |
| Native Route Shortcuts | Client-native route prompts for single/subagent/team/harness lanes | Claude/Gemini/OpenCode: /team <task>; Codex: /prompts:team <task> |
| Native Token Compression | Self-contained input/output token reduction inspired by RTK/Caveman patterns, without installing competitor tools | context:pack --token-budget 1200 --token-strategy balanced |
| Model Router | Intelligent multi-model dispatch for Agent Teams — match tasks to optimal model by capability, cost, and success rate | node scripts/aios.mjs model-router route --task "..." |
| Agent Team | Multi-agent parallel collaboration with HUD visual tracking | aios team 3:codex "task description" |
| Solo Harness | Single-agent overnight tasks with resume support and run journal | aios harness run --objective "goal" --worktree |
| Perception | Content outcome tracking + statistical insights + perception injection | aios perception record / insights / summary |
| Browser MCP | Stealth browser automation over CDP | aios internal browser doctor |
| Superpowers | Reusable workflow skills (brainstorm/plan/debug/verify) | Select from TUI |
| Privacy Guard | Auto-redact sensitive files before sharing | aios privacy status |
Quick Tour
# Launch TUI
aios
# Save a Git-friendly project memo
aios memo add "Remember to keep auth tests strict"
aios memo storage status
# Route from inside native clients after setup
# Claude/Gemini/OpenCode: /team <task>
# Codex: /prompts:team <task>
# Multi-agent collaboration
aios team 3:codex "Refactor the auth module and run tests"
# Single-agent overnight task
aios harness run --objective "Finish the handoff docs for tomorrow" --worktree
# Intelligent model routing
node scripts/aios.mjs model-router route --task "Review auth.js for security issues"
# Native token-compressed ContextDB packet
cd mcp-server && npm run contextdb -- context:pack --session <session_id> --token-budget 1200 --token-strategy balanced
# Content outcome tracking
aios perception record --content-id note_001 --platform xiaohongshu --content-type note --title "Test" --metrics '{"likes":100}'
# Check task status
aios team status --provider codex --watch
How It Works
User → codex / claude / gemini / opencode / antigravity / crush
→ zsh wrapper (transparent)
→ ctx-agent.mjs (ContextDB integration)
→ contextdb CLI (memory persistence)
→ launch native CLI (with context pack)
→ browser MCP (optional browser automation)
After installation, just use codex, claude, gemini, opencode, antigravity, or crush as usual — Harness CLI automatically loads project memory in the background and provisions route shortcuts where the client supports them.
Docs
- Quick Start — Install, configure, first run
- Model Router — Multi-model dispatch for Agent Teams
- ContextDB — Project memory system
- Agent Team — Multi-agent collaboration guide
- Solo Harness — Overnight task guide
- Perception — Content outcome tracking & insights
- Architecture — System architecture
- Troubleshooting — Common issues
- Use Cases — Find commands by scenario
Requirements
- Git
- Node.js 24 LTS + npm
- Windows: PowerShell 5.x or 7
Development
git clone https://github.com/rexleimo/harness-cli.git
cd harness-cli
Verify:
cd mcp-server
npm test
npm run typecheck
npm run build
License
See CHANGELOG.md for version history.