autonomOS — Multi-agent harness for CLI coding agents

## Why autonomOS

Running several coding-CLI agents today means a grid of terminal tabs you babysit — copy-pasting context, relaying every hand-off by hand. autonomOS turns them into a team that coordinates directly, across whichever CLI each agent runs.

`agent://` A message bus for coding agents

A URI gateway routes messages between running sessions — a Claude Code agent hands off to a Codex one with no human relay, and delivery is confirmed, not assumed.

`mcp` Cross-CLI by design

Claude Code, Codex, and Gemini share one MCP toolbelt and one address space. Orchestration is written once and works across every runtime.

`org` An org chart, like a company

Agents organize into managers and reports — work delegates down the tree and escalates up it, on a hierarchy you shape at runtime. Not a flat pool of tabs.

`live` Coordination you can watch

Hook telemetry streams every agent's status as they work and message each other — split-pane terminals, schedules, notifications. Browser-native and always-on: close your laptop, the fleet keeps working.

## Coding-CLI support

CLI-agnostic by design: every runtime plugs into the same bus and the same toolbelt. Claude Code and Codex are fully supported; Gemini is partial.

Capability	Claude Code	Codex	Gemini
Spawn as a managed session	✓	✓ daemon + remote TUI	✓
Live status telemetry	✓ hooks	✓ event stream	✓ hooks, translated
Shared MCP toolbelt	✓	✓	✓
Send to other agents	✓	✓	✓
Receive from other agents	✓	✓ native, inline	✗ not yet
Permission modes	✓	✓	✓
Usage / token tracking	✓	✓	✗ not yet
Resume across restarts	✓	✓	! fresh session

## For developers

The GitHub repo is the front door for building on autonomOS — full docs, decision records, and contribution guides live there.

Install the daemon

curl -fsSL https://autonomos.terrylu.cloud/install.sh | bash

autonomos status   # is the daemon healthy?
autonomos logs -f  # follow the server log

Installs an OS-native service (launchd / systemd-user) and prints your dashboard URL. Requires Node 20+.

Run from source

git clone https://github.com/aterrylu/autonomOS
cd autonomOS && bun install
make dev           # API :3101 + Vite HMR :5173
make check         # lint + typecheck + tests

Fork-friendly: MIT-licensed, with CONTRIBUTING and issue templates in the repo.

Self-host on your own box

make deploy DEPLOY_HOST=your-host

Rsyncs to a homelab server or VPS and supervises it there — your agents live on hardware that's always on. Auth is always on; every route requires the token.