codex-collab

# 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. Requires bun and the codex CLI on PATH (`codex-collab health` to verify). ## 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. ```bash # Research task codex-collab run "what does this project do?" -s read-only --content-only # Implementation task codex-collab run "add input validation to the login form" --content-only # Resume an existing thread (preserves conversation context) codex-collab run --resume <id> "now check the error handling" --content-only # Specify working directory (omit -d if already in the project dir) codex-collab run "investigate the auth module" -d /path/to/project --content-only # Long or quote-riddled prompt: pass it on stdin with `run -` (no shell-quoting hazards) cat prompt.md | codex-collab run - --content-only ``` **IMPORTANT — Execution rules for ALL `codex-collab` Bash commands:** - Always use `dangerouslyDisableSandbox=true` — the tool writes to `~/.codex-collab/` which is outside the sandbox allowlist. - For `run` and `review`: also use `run_in_background=true` — these take minutes. After launching, tell the user it's running and end your turn. **Wh...