The meta harness engineering system for agents.
also available as ag.
Trusted by engineers at
Profiles resolve model, provider, version, and credentials before the underlying CLI starts.
One prompt surface for the CLIs you already use. Pin versions per project, swap models through profiles, rotate accounts when quota is tight, and keep the command shape stable. Run docs →
$ agents profiles add kimi $ agents run kimi "refactor the queue worker"
The harness keeps quota, model choice, and project defaults out of ad-hoc shell glue. Runs spread across your accounts with the balanced strategy, one agent pipes into another, and the project decides the installed version. Rotation docs →
$ agents run claude --balanced "run the full test suite" $ agents run claude "Find auth bugs" | agents run codex "Patch them" $ agents usage
Parallel work gets named teammates, boundary contracts, DAG dependencies, logs, and cloud dispatch — on one machine or across your fleet.
Teams add isolated worktrees, --after dependencies, live status, and a durable transcript trail. It is still git and shell underneath; the harness just keeps parallel work legible. Teams docs →
$ agents teams create checkout $ agents teams add checkout codex "Owns: app/payments/*" --name payments $ agents teams add checkout claude "Run Playwright" --name qa --after payments $ agents teams start checkout --watch
Teammates run on other machines over SSH. Declare a device pool and the scheduler places them, or pin a teammate to a specific box; agents doctor --devices shows agent readiness across the fleet. Teams docs →
$ agents teams create feat --devices yosemite-s0,yosemite-s1 $ agents teams add feat claude "Owns: api/*" --name api $ agents teams start feat --watch $ agents doctor --devices
Every transcript lands in one searchable store, so prior attempts are a command away.
Find the debugging trail, the abandoned attempt, or the one command that worked last week. Sessions can be searched, replayed as markdown, filtered by project, and tailed while agents are still running — and sessions focus drops you back into any of them, wherever it lives. Sessions docs →
$ agents sessions "stripe webhook signature" $ agents sessions a7f3e2c1 --markdown $ agents sessions --active $ agents sessions focus a7f3e2c1
Browser, secrets, routines, PTY, computer, and devices are command surfaces under the same harness.
The harness reaches the parts agents usually lose: logged-in browser profiles, Keychain bundles, scheduled runs, remote devices, native apps, and interactive terminals. agents run --host puts a whole run on another machine over SSH. Devices docs →
$ agents browser start --profile work --url https://linear.app $ agents secrets exec prod -- npm run deploy $ agents pty start -- npm run dev $ agents run claude --host mac-mini
Routines turn repeatable agent work into a schedule. Standups, weekly digests, nightly audits, and one-shot follow-ups stay tied to the same agent profiles and logs. Schedule docs →
$ agents routines add standup \ --schedule "0 9 * * 1-5" \ --agent claude \ --prompt "Draft a standup from yesterday's git log"
On macOS, press Command-Shift-O (⌘⇧O), describe the problem, add screenshots, and choose File Ticket or Fix. A ticket agent carries every selected file into the issue wherever it fits best. Fix sends the same context to every selected agent. Menu bar docs →
⌘⇧O describe checkout email is blank mode File Ticket agent Claude files 3 screenshots attached
Most tools give you one piece. agents gives you all of them.
| Capability | agents-cli | Claude Code alone | Cursor | Run CLIs by hand | OpenCode |
|---|---|---|---|---|---|
| Pin versions per project (.nvmrc-style) | ✓ | — | — | — | — |
| Run multiple agents (Claude + Codex + Grok) from one CLI | ✓ | — | — | ~ | — |
| Swap underlying model (Kimi, GLM, DeepSeek via OpenRouter) | ✓ | — | ~ | — | ✓ |
| Rotate across multiple accounts to dodge rate limits | ✓ | — | — | — | — |
| Parallel teams with DAG dependencies | ✓ | — | — | — | — |
| Distribute teammates across machines over SSH | ✓ | — | — | ~ | — |
| Local browser via CDP (drive any site) | ✓ | — | — | — | — |
| Cross-agent session search & replay | ✓ | ~ | — | — | ~ |
| Cron / scheduled routines | ✓ | — | — | ~ | — |
| Keychain-backed secrets (no .env files) | ✓ | — | — | — | — |
| Sync skills/MCP/commands across all installed agents | ✓ | ~ | — | — | ~ |
| Local-first and open-source — cloud dispatch optional | ✓ | — | — | ✓ | ✓ |
# via curl $ curl -fsSL agents-cli.sh | sh # via bun $ bun install -g @phnx-labs/agents-cli # via npm $ npm install -g @phnx-labs/agents-cli
Claude Code
Codex
Cursor
OpenCode
Copilot
OpenClaw
Kiro
Goose
Gemini