<p align="center" <img src="assets/logo.png" alt="agi-cli" width="120" / </p

<h1 align="center"agi-cli</h1

<p align="center" <a href="https://www.npmjs.com/package/@phnx-labs/agents-cli"<img src="https://img.shields.io/npm/v/@phnx-labs/agents-cli.svg?style=flat-square" alt="npm version" /</a <a href="./LICENSE"<img src="https://img.shields.io/npm/l/@phnx-labs/agents-cli.svg?style=flat-square" alt="license" /</a <a href="https://www.npmjs.com/package/@phnx-labs/agents-cli"<img src="https://img.shields.io/npm/dm/@phnx-labs/agents-cli.svg?style=flat-square" alt="downloads" /</a <a href="https://github.com/phnx-labs/agi-cli"<img src="https://img.shields.io/badge/github-phnx--labs%2Fagi--cli-blue?style=flat-square" alt="github" /</a </p

A framework for running a distributed agent factory. Dispatch Claude, Codex, Antigravity, Grok, and more across your own machines, in parallel, on your existing subscriptions. Measure every run with agents insights (latency lives at agents insights perf), fold what you learn back into AGENTS.md and skills, then put the loop on a schedule with routines and monitors. Spawn parallel teams in isolated terminals or dispatch to the cloud for a PR. Watch live state across the fleet, nudge stalled runs, and message agents mid-flight. Store secrets behind Touch ID, drive real browsers and Electron apps, and steer the whole fleet from a menu bar — all from one CLI.

<p align="center" <a href="https://github.com/anthropics/claude-code" title="Claude Code"<img src="assets/harnesses/anthropic.svg" height="32" alt="Claude Code" /</a      <a href="https://github.com/openai/codex" title="Codex CLI"<img src="assets/harnesses/openai.svg" height="32" alt="Codex CLI" /</a      <a href="https://github.com/google-gemini/gemini-cli" title="Gemini CLI"<img src="assets/harnesses/google.svg" height="32" alt="Gemini CLI" /</a      <a href="https://cursor.com" title="Cursor"<img src="assets/harnesses/cursor.svg" height="32" alt="Cursor" /</a      <a href="https://github.com/sst/opencode" title="OpenCode"<img src="assets/harnesses/opencode.png" height="32" alt="OpenCode" /</a      <a href="https://github.com/openclaw/openclaw" title="OpenClaw"<img src="assets/harnesses/openclaw.svg" height="36" alt="OpenClaw" /</a      <a href="https://github.com/NousResearch/hermes-agent" title="Hermes Agent"<img src="assets/harnesses/hermes.png" height="32" alt="Hermes Agent" /</a      <a href="https://x.ai" title="Grok Build (xAI)"<picture<source media="(prefers-color-scheme: dark)" srcset="assets/harnesses/grok.png"<img src="assets/harnesses/grok-light.png" height="32" alt="Grok Build" /</picture</a      <a href="https://factory.ai" title="Factory AI Droid"<picture<source media="(prefers-color-scheme: dark)" srcset="assets/harnesses/droid.png"<img src="assets/harnesses/droid-light.png" height="32" alt="Factory AI Droid" /</picture</a      <a href="https://dev.meta.ai/docs/muse-code" title="Meta Muse Code"<picture<source media="(prefers-color-scheme: dark)" srcset="assets/harnesses/muse.svg"<img src="assets/harnesses/muse-light.svg" height="32" alt="Meta Muse Code" /</picture</a           <a href="https://docs.warp.dev/reference/cli" title="Warp Agent CLI (Oz)"<picture<source media="(prefers-color-scheme: dark)" srcset="assets/harnesses/warp.svg"<img src="assets/harnesses/warp-light.svg" height="32" alt="Warp Agent CLI" /</picture</a </p

<p align="center" <img src="assets/demos/hero.gif" alt="agents CLI: sessions across every agent and project, chaining agents in a Unix pipeline, dispatching to the cloud, and one team spread across machines" width="860" / </p

<p align="center"<a href="https://agi-cli.sh/demo.mp4"Watch the full 56-second demo</a</p

Quickstart

npm install -g @phnx-labs/agents-cli   # or: curl -fsSL agi-cli.sh | sh
agents setup                           # first-time setup, or re-open the capability hub
agents setup status                    # readiness for browser, computer, fleet, and more
agents run claude "explain this repo"  # run any agent on your existing subscription

Everything here — and every other command in this README — is free and needs no account; the optional agents auth login unlocks the hosted surfaces — team spaces and managed trace sync (agents traces sync with no Cloudflare setup). agents setup is interactive and idempotent -- safe to re-run on any machine. Once core setup exists, it opens a status-aware menu for browser, computer, secrets, term, fleet, watchdog, and device preferences; each choice delegates to the same wizard available under agents setup <capability. In CI or another non-TTY, bare setup prints the checklist without prompting. The agi-cli.sh one-liner installs this same canonical @phnx-labs/agents-cli package. Prefer bun? bun install -g @phnx-labs/agents-cli works too.

The command surface teaches setup through agents setup and group-level --help. The durable system model starts at cli/docs/README.md.

What agents setup installs, and what auto-updates. Setup clones a small public system repo (phnx-labs/.agents-system) into ~/.agents/.system/. It ships the default resources — including hooks, which run as shell commands on tool events — and its checkout fast-forwards from its origin when you run agents use (and, only if you opt in with AGENTSAUTOPULL=1, in the background). Two safeguards bound that: the pull is merge --ff-only (it can never rewrite your local history), and it is verified against the expected origin — a checkout whose origin is not the canonical system repo (or the exact repo you named in AGENTSSYSTEMREPO) is refused, never pulled, so a repointed remote cannot slip hook code onto your machine. To pin or opt out: set AGENTSSYSTEMREPO=gh:you/your-fork to track your own audited copy, run agents setup --no-system-repo to skip the clone entirely, or check out a specific tag in ~/.agents/.system/ (a fast-forward only advances a moving branch, so a detached tag stays put).

Learn (concepts): Loop + graph engineering · Teams as graph engineering · Sessions · index + cross-device · Distributed fleet execution. Also: harness engineering · visual longform.

Already installed? agents upgrade updates agi-cli itself to the latest version (agents upgrade 1.2.3 for a specific version or dist-tag, -y to skip the confirm prompt). The command is upgrade on every platform -- do not reach for agents update, which updates an installed agent harness, not agi-cli (and on macOS, agents helper update is a third thing: it reinstalls the keychain helper).

Source: github.com/phnx-labs/agi-cli

Also available as ag -- all commands work with both agents and ag.

Factory loop
One config, every agent
Run any agent
Sessions across agents
Control the fleet
Sync the fleet

Pin versions per project
Run open models through Claude Code
Run on your own machines
Teams
Cloud
Workflows

Installation

README.md

Quickstart

Related tools