ORCH — orchestrate Gemini CLI + Claude Code + Codex as a managed AI team from one CLI

[oxgeneral]

Hey Gemini CLI community! 👋

I built ORCH — an open-source CLI runtime that can orchestrate Gemini CLI alongside Claude Code, Codex, and Cursor as a structured engineering team.

Quick demo

npm install -g @oxgeneral/orch
orch init

# Add Gemini CLI as an agent via shell adapter
orch agent add "Gemini Worker" --adapter shell --command "gemini"

# Tasks auto-routed to available agents
orch task add "Write unit tests for auth module" -p 2
orch task add "Refactor API endpoints" -p 1

# TUI dashboard — see all agents live
orch tui

What ORCH adds on top of raw Gemini CLI calls

• State machine: todo → in_progress → review → done
• Mandatory review step: no skipping directly to done
• Auto-retry with configurable backoff
• Inter-agent messaging: agents can hand off context to each other
• Goal system: orch goal add "Ship v2 feature" → auto-decomposes into tasks
• Teams: dedicated backend, frontend, QA agent groups

Why this matters for Gemini CLI users

Running one Gemini CLI session is great. Running 5 in parallel without losing track of what each is doing is chaos without an orchestration layer. ORCH is that layer.

🔗 GitHub: https://github.com/oxgeneral/ORCH
📦 npm install -g @oxgeneral/orch
✅ TypeScript strict, 1493 tests

Anyone else building multi-agent workflows with Gemini CLI? What are your biggest pain points with parallel agents?