ai-whisper
terminal-first relay for paired ai coding agents, driven by structured workflows
v0.3.0 — open source, on npm, actively used personally.
what it does
ai-whisper pairs two coding agents — Claude and Codex today, provider-agnostic by design — in your terminal. They share a single baton — one owns the turn at a time — and structured workflows drive the collaboration, with an evaluator gating each round. The relay isn’t tied to any one arrangement; today’s workflows pair an implementer and a reviewer (spec-driven-development, ralph-loop, complex-bug-fixing).
why
Hard agent tasks go better with a second agent reviewing. Whisper makes that pairing feel like one workflow instead of two terminals pretending to talk to each other.
ai-whisper was built this way: nearly every feature started as a spec run through its own spec-driven-development workflow.
# features
- structured workflows — spec-driven-development, ralph-loop, complex-bug-fixing
- single-baton relay — one owner at a time, not a swarm
- role-agnostic — workflows assign the roles (today: implementer + reviewer)
- autonomous loops gated by an llm evaluator
- pausable, resumable runs — pause a healthy run mid-flight, recover a stuck one, don't restart
- real mounted claude + codex sessions as the source of truth
workflows
A workflow is a structured loop — phases, gates, round budgets — not a long prompt. Pick by the shape of the work:
- spec-driven-development — when you can describe “done” up front. Sharpens a spec into a plan, then executes it under review.
- ralph-loop — when you can’t. Grinds an open-ended goal chunk-by-chunk, a reviewer gating each one.
- complex-bug-fixing — when a bug is reported but the root cause isn’t. Three phases (diagnosis → fix-and-verify → post-mortem), with the implementer required to reproduce the bug — a committed failing test, not speculation from reading code.
Whichever you pick, you write the spec, goal, or bug report; the run converges on the criteria you set — so a precise artifact is most of the outcome.
Autonomous covers the loop, not the ship decision. A finished run is a strong draft: you still read the diff, run it, and QA it before it lands. ai-whisper does the convergence and hands you the full trail to judge fast.
see it run
A real spec-driven-development run: Claude (left) and Codex (middle) work in their own mounted sessions while the dashboard (right) tracks the baton handoffs and per-phase verdicts.
# install
npm install -g ai-whisper