Codex Orchestrator

Codex Orchestrator

Delegate tasks to OpenAI Codex agents via tmux sessions. Designed for Claude Code orchestration.

Spawn parallel coding agents, monitor their progress, send follow-up messages mid-task, and capture results - all from Claude Code or the command line.

Installation

As a Claude Code Plugin (Recommended)

Step 1: Add the marketplace:

Step 2: Install the plugin:

Step 3: Restart Claude Code (may be required for the skill to load)

Step 4: Install the CLI and dependencies:

Or say "set up codex orchestrator" and Claude will walk you through it.

Step 5: Use it - just ask Claude to do things. The skill activates automatically for coding tasks.

Manual / CLI-Only Install

If you just want the codex-agent CLI without the Claude Code plugin:

Or use the automated installer:

Requirements

Platform support: macOS and Linux. Windows users should use WSL.

Why?

When you're working with Claude Code and need parallel execution, investigation tasks, or long-running operations - spawn Codex agents in the background. They run in tmux sessions so you can:

- Watch live - Attach to any session and see exactly what the agent is doing
- Talk back - Send follow-up messages mid-task to redirect or add context
- Run in parallel - Spawn multiple agents investigating different parts of a codebase
- Capture results - Grab output programmatically when agents finish

Claude handles the strategic thinking (planning, synthesis, communication). Codex handles the deep coding work (research, implementation, review, testing). Together they cover both the orchestration and execution layers.

Codebase Map (Recommended)

The --map flag injects docs/CODEBASE_MAP.md into every agent's prompt, giving them instant understanding of your entire codebase: file purposes, module boundaries,…