explaingit

martyaxel/ai-orchestrator-runbook

Analysis updated 2026-05-18

1Audience · developerComplexity · 1/5Setup · easy

TLDR

A single runbook file that sets up a two-agent workflow where Claude Code plans and Codex executes coding tasks.

Mindmap

mindmap
  root((AI Orchestrator Runbook))
    What it does
      Sets up two agent workflow
      Claude Code plans
      Codex executes
      One file setup
    Tech stack
      Markdown runbook
    Use cases
      Orchestrate coding agents
      Save on API pricing
      Automatic model routing
    Audience
      AI assisted developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up a two-agent AI coding workflow where Claude Code plans and Codex executes.

USE CASE 2

Reduce reliance on pay-per-use AI pricing by routing mechanical coding work through subscription-based assistants.

USE CASE 3

Hand a single runbook file to an AI agent and have it configure the workflow automatically.

USE CASE 4

Use a pre-built model routing table to let an orchestrating agent pick the right model per task.

What is it built with?

Markdown

How does it compare?

martyaxel/ai-orchestrator-runbook0xkinno/neuralvault0xlocker/d17-contracts
Stars111
LanguageTypeScriptSolidity
Setup difficultyeasyhardhard
Complexity1/54/55/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an active Claude Pro/Max subscription and a ChatGPT Plus/Pro subscription, no extra software beyond Cursor or VS Code.

The README does not state a license for this project.

In plain English

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.

Copy-paste prompts

Prompt 1
Fetch the ai-orchestrator-runbook and execute it in my Claude Code session.
Prompt 2
Explain how the orchestrator plus delegate workflow divides work between Claude Code and Codex.
Prompt 3
Show me what the CLAUDE.md model routing table in this runbook is used for.
Prompt 4
Walk me through the subscriptions I need before running this runbook.

Frequently asked questions

What is ai-orchestrator-runbook?

A single runbook file that sets up a two-agent workflow where Claude Code plans and Codex executes coding tasks.

What license does ai-orchestrator-runbook use?

The README does not state a license for this project.

How hard is ai-orchestrator-runbook to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ai-orchestrator-runbook for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.