agi-cli (AGI CLI) is an open-source meta-harness that runs every CLI coding agent — Claude Code, Codex, Gemini, Cursor, and more — from one interface. Install it with `curl -fsSL agi-cli.sh | sh`; it lands on your PATH as `agents` (alias `ag`). One install, one config, every agent.

Yes. agi-cli is free and open source under Apache-2.0. It runs agents on your existing subscriptions, so there are no per-token API costs and no agi-cli account — nothing to sign up for.

Which coding agents does agi-cli support?

Claude Code, Codex, Gemini, Cursor, OpenCode, Grok, Kimi, Droid and more — plus any model (Kimi, MiniMax, GLM, Qwen, DeepSeek) through OpenRouter profiles. You run them individually, pin versions per project, or spawn them as parallel teams.

How is agi-cli different from Claude Code?

Claude Code is one agent. agi-cli runs and orchestrates all of them — version-pinned per project like .nvmrc, in parallel teams with boundary contracts, with skills, MCP servers, secrets, and searchable sessions shared across every agent from one config source.

How do I install agi-cli?

Run `curl -fsSL agi-cli.sh | sh`. It works on macOS, Linux, and Windows.

How-to

Dodge rate limits by rotating across accounts

The 5-hour session window hits 100% and the run stalls. With several signed-in accounts, the balanced strategy sends each run to one that has capacity to spare.

Muqsit Nawaz · Published July 17, 2026

The default

Since CLI 1.20.43, balanced is the default run strategy. You get load-spreading with no flag: agents run distributes work across healthy accounts by remaining capacity and skips any account whose usage window is maxed out.

agents run claude "run the full test suite"   # balanced by default
agents run claude "..." --balanced             # or state it explicitly (-b)

An account is skipped when any usage window — including the 5-hour session window — is at 100%, matching the badge in agents view. A pinned @version, a profile, or --fallback disables balancing for that run.

The three strategies

Set the strategy per run with --strategy, or as a default viarun.<agent>.strategy in agents.yaml:

pinned — always use the workspace/global pinned version.
available — use the pinned version if it can run right now; otherwise switch to another signed-in version.
balanced — distribute load across healthy accounts by remaining capacity. The default. (Legacy rotate is accepted as an alias.)

# ~/.agents/agents.yaml
run:
  claude:
    strategy: balanced

Read the gauge

agents usage shows the rate-limit window for every account it knows about, so you can see who has headroom before dispatching.

agents usage           # every installed agent + account
agents usage claude    # just Claude

Claude
  [email protected]
  Usage

    Current session            ██░░░░░░░░ 18% used
    Resets 5 PM (America/Los_Angeles)

    Current week (all models)  █████░░░░░ 53% used
    Resets Jul 14, 7 AM (America/Los_Angeles)

The gauge feeds the balanced strategy: an account near a reset with fresh headroom gets picked first, one at 100% is skipped until its window resets. Query another machine's accounts with agents usage --host <name>.

Try it

curl -fsSL agi-cli.sh/install.sh | sh

Install guide Rotate accounts docs →