Codex Orchestrator

Codex Orchestrator

CLI tool for delegating tasks to GPT Codex agents via tmux sessions. Designed for Claude Code orchestration with bidirectional communication.

**Stack**: TypeScript, Bun, tmux, OpenAI Codex CLI

**Structure**: Shell wrapper -> CLI entry point -> Job management -> tmux sessions

For detailed architecture, see [docs/CODEBASE_MAP.md](docs/CODEBASE_MAP.md).

Development

# Run directly
bun run src/cli.ts --help

# Or via shell wrapper
./bin/codex-agent --help

# Health check
bun run src/cli.ts health

Key Files

File	Purpose
src/cli.ts	CLI commands and argument parsing
src/jobs.ts	Job lifecycle and persistence
src/tmux.ts	tmux session management
src/config.ts	Configuration constants
src/files.ts	File loading for context injection
src/session-parser.ts	Parse Codex session files for metadata
plugins/	Claude Code plugin (marketplace structure)

Plugin Structure

This repo doubles as a Claude Code plugin marketplace:

.claude-plugin/marketplace.json     # marketplace registry
plugins/codex-orchestrator/         # the plugin
  .claude-plugin/plugin.json        # plugin metadata
  skills/codex-orchestrator/        # the orchestration skill
    SKILL.md                        # skill instructions
  scripts/install.sh                # dependency installer

Dependencies

undefined

Notes

undefined

Claude Orchestration Pattern (Persisted)

undefined