A local-first workflow layer for `codex`, `claude`, `gemini`, `opencode`, `hermes`, and `grok` (Grok Build). It adds project memory, collaboration, routing, and verification without replacing the coding client you already use.
Docs | Quick Start | Workflow Policy | Blog | Friends | Changelog | GitHub
macOS / Linux:
```bash curl -fsSL https://github.com/rexleimo/harness-cli/releases/latest/download/aios-install.sh | bash source ~/.zshrc aios init --all aios doctor --native --verbose ```
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 init --all aios doctor --native --verbose ```
Run the commands from a project root when you want project-level client guidance and memory. For unattended setup, use `node scripts/aios.mjs init --all --yes-compression-tools --yes-headroom-mcp`; these flags explicitly authorize package installation and user-scope MCP registration.
rex-harness is a required AIOS planning runtime. Release installers bundle the pinned submodule contents automatically, so a release install does not need a second npm package or MCP service. When working from source, prefer git clone --recurse-submodules https://github.com/rexleimo/harness-cli.git; if the repository was cloned without submodules, aios init/aios setup automatically attempts git submodule update --init --recursive -- rex-harness and stops with a remediation message if it cannot recover the kernel.
Harness CLI is a set of cooperating layers. Each layer has a different responsibility and an explicit boundary:
| Layer | What it provides | Start here |
|---|---|---|
| ContextDB | Pull-based project memory, memos, checkpoints, and searchable context packs | `aios init` and ContextDB |
| Workflow Policy | Risk-based `noop`, `direct`, `guarded`, and `planned` routing, with explicit plan persistence | Workflow Policy |
| rex-harness Control Plane | Standalone Fact、Capability、Workflow Activation、compact Command、Evidence Contract 和本地恢复 | `rex-harness init --client codex` / `rex-harness start` |
| Agent Team / Solo Harness | Parallel collaboration or resumable long-running work with status and evidence | `aios team` / `aios harness run` |
| RTK | Local filtering for noisy shell and tool output | `aios init --all` |
| Caveman | A concise response-style skill that keeps technical facts visible | `aios init --all` |
| Headroom MCP | Explicit, on-demand compression and retrieval through supported MCP clients | `aios init --all --yes-headroom-mcp` |
| Verification and Privacy | Tests, diagnostics, quality gates, and redaction before sensitive sharing | `aios doctor` / `aios privacy` |
RTK, Caveman, and Headroom have different integration boundaries. Harness CLI does not claim that every client launch is automatically wrapped, that provider traffic disappears, or that a compression percentage applies to your project without measurement.
rex-harness 与 AIOS 不是两套互相竞争的工作流。rex 是可独立运行的软件工程控制面，自己拥有 Fact、Capability、adaptive-software-delivery Workflow Activation、Command、Evidence Contract 和 .rex-harness/ 恢复状态；独立 Coding Agent 通过 rex-workflow + compact CLI 使用它，AIOS 则直接调用完整 JS API，并增加 direct | guarded | planned、最终 Provider Binding、Agent 晋级与执行、ContextDB、安全门、Team 和可恢复 Harness。父项目不注册 rex MCP，只读投影 rex 的当前命令语义，同时继续拥有自己的治理与长循环 Recipe。
```bash
aios init --all
aios doctor --native --verbose
aios memo add "Keep authentication tests strict" aios memo search "authentication"
aios team 3:codex "Review the auth module and update its tests" aios harness run --objective "Finish the release handoff" --worktree
node scripts/aios.mjs plan auto-gate --task "Refactor the auth module" --dry-run --json ```
The project marker points clients to `.aios/context-db/index.json`. ContextDB is pull-based: the agent can search or recall relevant project material instead of receiving the whole history on every prompt. The exact files and commands are described in ContextDB.
Harness CLI currently provides native or compatibility integrations for `codex`, `claude`, `gemini`, `opencode`, `hermes`, and `grok` (Grok Build). Feature depth varies by client; run `aios doctor --native --verbose` to inspect the local installation rather than assuming every client supports every route.
- Quick Start - install, initialize, and verify the first project.
- Windows Guide - PowerShell prerequisites and recovery commands.
- Workflow Policy - choose the smallest correct route and understand plan continuation.
- ContextDB - local storage, unified search, memo scope, and context packs.
- Token Intelligence - RTK, Caveman, Headroom MCP, and safe context boundaries.
- Agent Team - governed parallel work with HUD evidence.
- Solo Harness - resumable long-running work.
- Use Cases - commands organized by user intent.
- Architecture - runtime layers and compatibility boundaries.
- Troubleshooting - observable symptoms and recovery steps.
- Blog - tutorials, release notes, and reproducible workflows.
- Git
- Node.js 24 LTS and npm
- Windows: PowerShell 5.x or 7
- At least one supported coding client
```bash git clone https://github.com/rexleimo/harness-cli.git cd harness-cli npm run test:scripts cd mcp-server npm run typecheck npm test npm run build ```
See CHANGELOG.md for version history.