RexCLI (AIOS)

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

Docs | Quick Start | Case Library | GitHub

Install

macOS / Linux:

curl -fsSL https://github.com/rexleimo/rex-cli/releases/latest/download/aios-install.sh | bash
source ~/.zshrc
aios

Windows PowerShell:

irm https://github.com/rexleimo/rex-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
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

# 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"

# 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
     → 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, or gemini as usual — RexCLI automatically loads project memory in the background.

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 22 LTS + npm
• Windows: PowerShell 5.x or 7

Development

git clone https://github.com/rexleimo/rex-cli.git
cd rex-cli

Verify:

cd mcp-server
npm test
npm run typecheck
npm run build

License

See CHANGELOG.md for version history.