Three AI agents. One brain. Zero downtime. Multi-agent CLI orchestrator with next-man-up failover for Claude, Codex, and Gemini.

agent-orchestrator

Three AI agents. One brain. Zero downtime.

A terminal-based multi-agent orchestrator that wraps Gemini, Codex, and Gemini CLIs with automatic failover. When one agent hits its limit, the next one picks up seamlessly. All agents share context through a knowledge base server. $60/month for three premium AI agents — no API billing.

How It Works

You type a message
       |
       v
  [Orchestrator]
       |
       +---> Try Agent 1 (Gemini) ---> Success? Return response
       |            |
       |         Failed/Down
       |            |
       +---> Try Agent 2 (Codex) ---> Success? Return response
       |            |
       |         Failed/Down
       |            |
       +---> Try Agent 3 (Gemini) --> Success? Return response
       |
  All failed? Show error + recovery options

Each message is routed through a role chain — an ordered list of agents to try. Roles include:

• orchestrator — planning, architecture, high-level reasoning (default: Gemini > Codex > Gemini)
• implementation — code execution, build tasks (default: Codex > Gemini > Gemini)
• uidocs — frontend, design, documentation (default: Gemini > Codex > Gemini)
• review — code review, validation (default: Gemini > Codex > Gemini)

Every role, chain order, and model is configurable.

Features

• Next-man-up failover — if an agent is down, the next one in the chain takes over automatically
• Auto-downtime detection — detects rate limits, quota exhaustion, auth failures, and auto-disables agents with cooldown timers
• CLI wrapping — uses your existing Gemini/Codex/Gemini CLI subscriptions, not per-token API billing
• Full-host unattended CLI defaults — Codex and Gemini can run headlessly with full permissions on trusted machines
• API mode available — switch any agent to API mode if you prefer
• Configurable name — call it whatever you want, not hardcoded
• Knowledge base integration — searches your KB server