whatisgithub

What is claude-codex-orchestrator?

vimoxshah/claude-codex-orchestrator — explained in plain English

Analysis updated 2026-05-18

3Audience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A Claude Code skill that has Claude plan and verify while OpenAI's Codex writes the actual code, splitting judgment from typing to save on expensive model time.

Mindmap

mindmap
  root((claude-codex-orchestrator))
    What it does
      Claude plans and verifies
      Codex executes code
      Escalates on failure
    Tech stack
      Claude Code
      Codex CLI
      GPT-5.6 models
    Use cases
      Implement a feature from a spec
      Fix a bug with a known repro
      Run a mechanical rename across files
    Audience
      Developers
      AI power users

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

Implement a feature from a written spec while Claude verifies the diff.

USE CASE 2

Fix a bug that has a known reproduction step and get a regression test.

USE CASE 3

Run a large mechanical rename across many files on a cheap execution lane.

USE CASE 4

Escalate a stuck task to a higher-effort model after repeated failures.

What is it built with?

Claude CodeCodex CLIGPT-5.6

How does it compare?

vimoxshah/claude-codex-orchestrator000madz000/payload-test-api-route-handler0marildo/imago
Stars333
LanguageTypeScriptPython
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Claude Code, an authenticated Codex CLI, and the official OpenAI Codex plugin installed first.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

claude-codex-orchestrator is a skill for Claude Code that splits work between two AI coding tools so you spend your more expensive model's time on judgment rather than typing. The idea is simple: Claude plans, breaks a task into pieces, and checks the results, while OpenAI's Codex actually writes the code. The README frames this as sending the thinking to the model best suited for design and review, and sending the mechanical writing to a fast, flat rate tool. The workflow runs in a loop. First Claude decomposes a problem into small, self-contained work packets, each one listing its goal, how to know it succeeded, which files it touches, what it should not touch, and the exact command that proves it worked. Codex then writes the code for one packet at a time, without making its own design decisions, and hands back both a code change and a written report describing what it did. Claude does not trust that report on its own, it treats the actual code change as the real evidence, re-runs every check the report claims passed, and watches for signs like weakened tests or claimed work that was not actually done. Based on that check, Claude marks the result verified, verified with caveats, or refuted. If a packet fails its checks twice, the system reroutes it to a different, more capable setup rather than blindly retrying the same approach a third time. Codex is configured through several named profiles, each pinned to a specific underlying model and a chosen reasoning effort level, for tasks like everyday implementation work, harder or more uncertain implementation, code review, deep diagnosis of a stuck task, purely mechanical bulk edits, and getting a second opinion. Setting it up requires having Claude Code and the Codex command line tool installed and authenticated, plus an official Codex plugin for Claude Code, after which you copy the provided profile files and the skill file into your configuration folders. The README walks through several worked examples, such as building a feature from a written spec, fixing a bug that has a known way to reproduce it, doing a large mechanical rename across many files, and digging into a task that keeps failing for unclear reasons. The project explicitly separates itself from a related project that routes between different Claude model tiers, saying the two should not be mixed. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install claude-codex-orchestrator's skill and lane profiles into my Claude Code setup.
Prompt 2
Walk me through setting up the official OpenAI Codex plugin needed for claude-codex-orchestrator.
Prompt 3
Explain how claude-codex-orchestrator decides to escalate a failed packet to a different model.
Prompt 4
Show me how to write a work packet for claude-codex-orchestrator to implement a CSV export endpoint.

Frequently asked questions

What is claude-codex-orchestrator?

A Claude Code skill that has Claude plan and verify while OpenAI's Codex writes the actual code, splitting judgment from typing to save on expensive model time.

What license does claude-codex-orchestrator use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude-codex-orchestrator to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-codex-orchestrator for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.