Skip to content

Harness CLI (AIOS)

A local agent workflow layer that adds memory, collaboration, and verification to codex / claude / gemini / opencode.

You keep using the same commands. Nothing changes about your workflow — except your agents get a brain, a team, and self-diagnostics.

Get Started in 3 Minutes See It In Action

Core Capabilities

Capability Description Command
ContextDB Cross-session project memory with events, checkpoints, and context packs auto-loaded by codex / claude / gemini / opencode
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 "..."
Codemap Tree-sitter code knowledge graph — one-command install gives all agents instant structural understanding of your codebase aios internal codemap install / doctor
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

How It Works

User → codex / claude / gemini / opencode
     → 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, or opencode as usual — Harness CLI automatically loads project memory in the background and provisions route shortcuts where the client supports them.

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

First Time Here?

Start here: Quick Start — install, set up, and run your first agent with memory in about 3 minutes.

Already set up? Jump to what you need:

I want to... Go to
Give my agent project memory ContextDB
Use multiple agents together Agent Team
Let one agent work overnight Solo Harness
Route tasks intelligently Model Router
Reduce token usage Token Compression
Find the right command 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

Docs

Blog Highlights