gitwtfhub

wtf is codex-claude-orchestrator?

coredo-eu/codex-claude-orchestrator — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

Codex Claude Orchestrator is a local plugin that lets OpenAI's Codex and Anthropic's Claude Code collaborate on one project, with Codex directing work and verifying results Claude produces.

Mindmap

mindmap
  root((codex-claude-orchestrator))
    What it does
      Codex to Claude handoff
      Local transport and policy
      Result verification
    Tech stack
      Python
      Codex CLI
      Claude Code CLI
    Use cases
      Bounded task delegation
      Combined subscriptions
      Role based model routing
    Audience
      Developers using Codex
      Developers using Claude Code

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

Why would anyone build with this?

REASON 1

Delegate bounded coding subtasks from a Codex session to a persistent Claude Code worker while Codex verifies the result.

REASON 2

Combine a ChatGPT Plus and a Claude Pro subscription into one coordinated local coding workflow.

REASON 3

Route different kinds of work, search, implementation, and review, to whichever Claude model fits best.

What's in the stack?

PythonCodex CLIClaude Code CLI

How it stacks up

coredo-eu/codex-claude-orchestrator0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an authenticated Codex CLI and an authenticated Claude Code CLI, plus active ChatGPT and Claude subscriptions.

No license information is stated in the shown portion of the README.

Wtf does this do

Codex Claude Orchestrator is a plugin that lets two separate AI coding tools, OpenAI's Codex and Anthropic's Claude Code, work together on the same local project instead of forcing a developer to pick one. Codex stays in overall charge: it decides what the user wants, whether handing work off to Claude is worth it, and it independently checks the result afterward rather than trusting it automatically. When delegation does happen, a single long-running Claude Code session acts as a parent that keeps context across related tasks and routes smaller pieces of work to different Claude models, Haiku for searching and quick triage, Sonnet for implementation and debugging, and Opus for review, with a rarely used Fable model reserved for unusually long tasks. The project describes itself as a transport and policy layer rather than a hosted service: there is no central coordinator, no credential relay, and no daemon running somewhere else. It simply launches the user's already-logged-in Claude Code command line tool locally and stores private state about which model is handling which task. If Claude becomes unavailable partway through, the system can fall back to Codex's own native roles, mapped to discovery, implementation, review, and security tasks, but only after Codex confirms Claude's work has stopped and control has properly returned. One of the stated motivations is combining two separate paid subscriptions, a ChatGPT Plus plan that includes Codex and a Claude Pro plan that includes Claude Code, into one workflow, rather than needing multiple accounts with a single provider. The project is explicit that it does not copy login credentials, share accounts, or turn a subscription into an unofficial API, each tool authenticates through its own official client, and the user remains responsible for following each provider's terms. A typical task flows through the system in stages: the user gives Codex a goal, Codex decides whether to handle it directly or delegate, and if delegating, it creates a bounded contract describing the outcome, boundaries, and what evidence would count as proof the task is actually done. The full README is longer than what was shown.

Yoink these prompts

Prompt 1
Explain how Codex decides whether to delegate a task to the Claude Code parent in this orchestrator.
Prompt 2
Walk me through installing this Codex marketplace plugin and connecting it to my Claude Code CLI.
Prompt 3
How does this project verify Claude's work instead of trusting it automatically once returned?
Prompt 4
Show me how the Haiku, Sonnet, and Opus roles are assigned to different kinds of work in this system.

Frequently asked questions

wtf is codex-claude-orchestrator?

Codex Claude Orchestrator is a local plugin that lets OpenAI's Codex and Anthropic's Claude Code collaborate on one project, with Codex directing work and verifying results Claude produces.

What language is codex-claude-orchestrator written in?

Mainly Python. The stack also includes Python, Codex CLI, Claude Code CLI.

What license does codex-claude-orchestrator use?

No license information is stated in the shown portion of the README.

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

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

Who is codex-claude-orchestrator for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.