agi-cli reference
Skills, commands, hooks — install once and sync to every CLI. Drive a real browser. Run agents in parallel with isolated worktrees. The full reference.
What can this do
agi-cli runs any coding agent as one fleet across your machines. Eleven capabilities, each with its own reference page.
Run agents in parallel
Named teammates on isolated worktrees, with --after DAG dependencies, live status, and a durable transcript trail.
Command a fleet over SSH
Register your machines and put a whole run on another box with --host. The scheduler places teammates across a device pool.
Dispatch to the cloud
agents cloud run hands a task to Rush, Codex, or a Factory droid — it works the repo end-to-end and opens a pull request.
Rotate accounts
--rotate picks the least-used account so a fleet of runs spreads across every login you have, without hitting one rate limit.
Search every run
Cross-agent session history: search by content, replay as markdown, filter by project, tail live runs, and jump back in with focus.
Drive a real browser
Agents control Chrome over CDP — logged-in profiles, screenshots, console errors, and DOM refs as a feedback signal.
Pin versions per repo
An agents.yaml at the repo root locks each CLI to a version — like .nvmrc, but for every coding agent.
Sync config everywhere
Skills, commands, hooks, rules, and MCP servers live in ~/.agents. Push once, pull on every machine and every harness.
Inject secrets safely
Keychain-backed bundles scope credentials to a single process. Nothing touches disk in plaintext.
Schedule background work
Wrap any run in a cron entry — a nightly dependency audit, a Monday triage — and read the result like any other session.
Cap what a run can spend
agents budget estimates cost before a run starts, blocks it on breach, and hard-kills a headless run the moment a cap is crossed — across every vendor.
Browse by section
Get started
Install agi-cli, run your first command.
Configure
Layered config, secrets, hooks, permissions.
Browser
Profiles and tabs for agent-driven browsing.
Parallel
Teams, worktrees, sessions — agents working at the same time.
Agents
Running CLIs, pinning versions, rotating accounts.
Devices
Register your machines, target any of them with --host / --device.
Costs
Track $ spend, cap it before a run starts, see which account is burning it.