martyaxel/ai-orchestrator-runbook — explained in plain English
Analysis updated 2026-05-18
Set up a two-agent AI coding workflow where Claude Code plans and Codex executes.
Reduce reliance on pay-per-use AI pricing by routing mechanical coding work through subscription-based assistants.
Hand a single runbook file to an AI agent and have it configure the workflow automatically.
Use a pre-built model routing table to let an orchestrating agent pick the right model per task.
| martyaxel/ai-orchestrator-runbook | 0xkinno/neuralvault | 0xlocker/d17-contracts | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | — | TypeScript | Solidity |
| Setup difficulty | easy | hard | hard |
| Complexity | 1/5 | 4/5 | 5/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires an active Claude Pro/Max subscription and a ChatGPT Plus/Pro subscription, no extra software beyond Cursor or VS Code.
ai-orchestrator-runbook is a single markdown file, not really a piece of software, that sets up a particular way of working with two different AI coding assistants together. The idea is that Claude Code handles the thinking: it plans out the work, breaks it into pieces, hands tasks off, and checks the results, while a separate assistant called Codex, based on a model referred to as gpt-5.5, does the actual mechanical execution of those tasks. According to the README, this arrangement is meant to give strong quality results while relying mostly on your subscription plans rather than paying premium, pay per use prices for routine work. Using it is meant to be very simple. You open whichever AI coding agent you already use, such as Claude Code or Cursor, and either give it the included file, called runbook.md, or just tell your agent to fetch it directly from its raw GitHub URL and execute it. From there, the agent is expected to carry out the whole setup itself, only pausing to ask you to log into a service when needed, and the whole process is estimated to take about three minutes. To use this setup, you need an active Claude subscription, either Pro or Max, along with an active ChatGPT subscription, either Plus or Pro, since the actual intelligence and capability come from those subscriptions rather than from the runbook file itself. You also need an editor like Cursor or VS Code, and the README notes that the free tier of either is enough. The runbook itself includes a model routing table, saved as a CLAUDE.md file, that describes the cost, intelligence, and stylistic tradeoffs of different models, which lets the orchestrating assistant automatically choose an appropriate model for each task without you having to decide manually.
A single runbook file that sets up a two-agent workflow where Claude Code plans and Codex executes coding tasks.
The README does not state a license for this project.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.