codex-collab

codex-collab is a bridge between Claude and Codex. It communicates with Codex via the codex app-server JSON-RPC protocol, giving you structured, event-driven access to Codex's capabilities — prompting, code review, tool use, and file editing.

Collaboration Modes

• Run — Single-command run for any prompted task (research, analysis, implementation). Starts a thread, sends prompt, waits for completion, returns output.
• Code review — Single-command review for PR-style, uncommitted, or commit-level review.
• Parallel work — You and Codex work on different parts simultaneously. Start multiple jobs.
• Research — Spin up a read-only Codex session to investigate something while you continue other work.

Run Command (Recommended for Prompted Tasks)

The run command handles prompted tasks in one call: starts a thread, sends the prompt, waits for the turn to complete, and prints output.

# Research task
codex-collab run "what does this project do?" -s read-only --content-only