What problem does it solve?
This Skill enables Claude to delegate coding tasks to Codex CLI for multi-model collaboration, empowering faster prototyping, debugging, and code reviews by leveraging Codex alongside Claude's orchestration.
Core Features & Use Cases
- Multi-turn sessions: Maintain context across prompts using SESSION_ID.
- Sandboxed execution: Supports read-only, workspace-write, and danger-full-access environments to control actions.
- JSON output: Structured responses suitable for programmatic consumption and integration.
- Agent role injection: Inject predefined agent roles from ~/.claude/agents/ to steer Codex behavior.
- Cross-platform compatibility: Handles Windows path escaping and environment differences.
Use Case: A developer asks for a feature plan, then iteratively refines code with Codex and Claude, all in a single session.
Quick Start
Use the codex bridge to run a simple prompt and get a structured JSON response:
- Basic: python3 scripts/codex_bridge.py --cd "/path/to/project" --PROMPT "Analyze the authentication flow"
- Multi-turn: Start with a session and reuse SESSION_ID for follow-up prompts
- Agent roles: python3 scripts/codex_bridge.py --cd "/project" --agent planner --PROMPT "Plan the auth module"