collaborating-with-codex
Delegates coding tasks to Codex CLI for prototyping, debugging, and code review. Use when needing algorithm implementation, bug analysis, or
Open source Repository Open in the app JSON README (API)
About
Delegates coding tasks to Codex CLI for prototyping, debugging, and code review. Use when needing algorithm implementation, bug analysis, or code quality feedback. Supports multi-turn sessions via SES
Details
- Kind
- Agent skills
- Topic
- Developer tools
- Publisher
- gudastudio
- Origin
- majiayu
- Category
- ferramentas
- Stars
- 132
- Forks
- 12
- Open pull requests
- 1
- Last push
- 2025-12-23T14:54:42Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-09-02 18:18:58
- Updated
- 2026-09-02 18:18:58
- Origin id
gudastudio/collaborating-with-codex/development/collaborating-with-codex-gudastudio-collaborating-with-c@main
README
# collaborating-with-codex
A Claude Code **Agent Skill** that bridges Claude with OpenAI Codex CLI for multi-model collaboration on coding tasks.
## Overview
This Skill enables Claude to delegate coding tasks to Codex CLI, combining the strengths of multiple AI models. Codex handles algorithm implementation, debugging, and code analysis while Claude orchestrates the workflow and refines the output.
## Features
- **Multi-turn sessions**: Maintain conversation context across multiple interactions via `SESSION_ID`
- **Sandboxed execution**: Three security levels (`read-only`, `workspace-write`, `danger-full-access`)
- **JSON output**: Structured responses for easy parsing and integration
- **Image support**: Attach images to prompts for visual context
- **Cross-platform**: Windows path escaping handled automatically
## Installation
1. Ensure [Codex CLI](https://github.com/openai/codex) is installed and available in your PATH
2. Copy this Skill to your Claude Code skills directory:
- User-level: `~/.claude/skills/collaborating-with-codex/`
- Project-level: `.claude/skills/collaborating-with-codex/`
## Usage
### Basic
```bash
python scripts/codex_bridge.py --cd "/path/to/project" --PROMPT "Analyze the authentication flow"
```
### Multi-turn Session
```bash
# Start a session
python scripts/codex_bridge.py --cd "/project" --PROMPT "Review login.py for security issues"
# Response includes SESSION_ID
# Continue the session
python scripts/codex_bridge.py --cd "/project" --SESSION_ID "uuid-from-response" --PROMPT "Suggest fixes for the issues found"
```
### Parameters
| Parameter | Required | Description |
|-----------|----------|-------------|
| `--PROMPT` | Yes | Task instruction |
| `--cd` | Yes | Workspace root directory |
| `--sandbox` | No | Security level: `read-only` (default), `workspace-write`, `danger-full-access` |
| `--SESSION_ID` | No | Resume a previous session |
| `--return-all-messages` | No | Include full reasoning trace in output |
| `--image` | No | Attach image files (comma-separated or repeated) |
| `--model` | No | Specify model (use only when explicitly requested) |
| `--yolo` | No | Bypass all approvals (use with caution) |
### Output Format
```json
{
"success": true,
"SESSION_ID": "uuid",
"agent_messages": "Codex response text",
"all_messages": []
}
```
## License
MIT License. See [LICENSE](LICENSE) for details.