{"id":"codex-cli-bridge","name":"codex-cli-bridge","summary":"Claude CodeとOpenAI Codex CLIのブリッジ - CLAUDE.md から AGENTS.md を生成し、Codex CLI実行ヘルパーを提供し、両ツール間のシームレスな相互運用性を可能にします","body":"# Codex CLI Bridge Skill\n\n## Purpose\n\nThis skill creates a comprehensive bridge between **Claude Code** and **OpenAI's Codex CLI**, enabling seamless interoperability through:\n\n1. **Documentation Translation**: Converts CLAUDE.md → AGENTS.md (reference-based, no file duplication)\n2. **Execution Helpers**: Python wrappers for Codex CLI commands (always uses `codex exec`)\n3. **Skill Documentation**: Makes Claude Skills accessible to Codex CLI users\n\n## Key Capabilities\n\n### 1. CLAUDE.md → AGENTS.md Generation\n- Parses CLAUDE.md and project structure\n- Scans `.claude/skills/`, `.claude/agents/`, `documentation/` folders\n- Generates comprehensive AGENTS.md with file path references\n- **Reference-based**: No file duplication, only links to existing files\n- Documents Skills with most relevant usage method (bash scripts vs prompt references)\n\n### 2. Safety Mechanism\n- **Auto-checks Codex CLI installation** (`codex --version`)\n- **Auto-runs `/init`** if CLAUDE.md missing (with user notification)\n- Validates authentication and environment\n- User-friendly error messages\n\n### 3. Codex CLI Execution Helpers\n- `exec_analysis()` - Read-only analysis tasks (gpt-5, read-only sandbox)\n- `exec_edit()` - Code editing tasks (gpt-5-codex, workspace-write)\n- `exec_with_search()` - Web search-enabled tasks\n- `resume_session()` - Continue last Codex session\n- **Always uses `codex exec`** (never plain `codex` - critical for Claude Code)\n\n### 4. Skill Documentation for Codex CLI\n- **Prompt-only skills**: Show how to reference in Codex prompts\n- **Functional skills**: Show how to execute Python scripts directly\n- **Complex skills**: Show both methods\n- Includes proper `codex exec` command syntax\n- Model selection guidance (gpt-5 vs gpt-5-codex)\n\n## Input Requirements\n\n### For AGENTS.md Generation\n```json\n{\n  \"action\": \"generate-agents-md\",\n  \"project_root\": \"/path/to/project\",\n  \"options\": {\n    \"validate_codex\": true,\n    \"auto_init\": true,\n    \"include_mcp\": true,\n    \"skill_detail_level\": \"relevant\"\n  }\n}\n```\n\n### For Codex Execution\n```json\n{\n  \"action\": \"codex-exec\",\n  \"task_type\": \"analysis|edit|search\",\n  \"prompt\": \"Your task description\",\n  \"model\": \"gpt-5|gpt-5-codex\",\n  \"sandbox\": \"read-only|workspace-write|danger-full-access\"\n}\n```\n\n## Output Formats\n\n### AGENTS.md Structure\n```markdown\n# AGENTS.md\n\n## Project Overview\n[From CLAUDE.md]\n\n## Available Skills\n### Skill Name\n**Location**: `path/to/skill/`\n**Using from Codex CLI**: [Most relevant method]\n\n## Workflow Patterns\n[Slash commands → Codex equivalents]\n\n## MCP Integration\n[MCP server references]\n\n## Command Reference\n| Claude Code | Codex CLI |\n|-------------|-----------|\n[Mappings]\n```\n\n### Execution Helper Output\n```python\n{\n  \"status\": \"success|error\",\n  \"output\": \"Command output\",\n  \"session_id\": \"uuid\",\n  \"model_used\": \"gpt-5|gpt-5-codex\",\n  \"command\": \"codex exec ...\"\n}\n```\n\n## Python Scripts\n\n### safety_mechanism.py\n- Check Codex CLI installation\n- Validate CLAUDE.md exists (auto-run /init if missing)\n- Environment validation\n- User notifications\n\n### claude_parser.py\n- Parse CLAUDE.md sections\n- Scan skills, agents, commands\n- Extract quality gates and MCP configuration\n- Return file paths only (no content duplication)\n\n### project_analyzer.py\n- Auto-detect project structure\n- Discover all Claude Code assets\n- Generate project metadata\n- Build reference map\n\n### agents_md_generator.py\n- Template-based AGENTS.md generation\n- File path references (no duplication)\n- Skill documentation (most relevant method)\n- Workflow translation (Claude → Codex)\n\n### skill_documenter.py\n- Document skills for Codex CLI users\n- Determine most relevant usage method per skill type\n- Generate bash examples for Python scripts\n- Create Codex prompt templates\n\n### codex_executor.py\n- Python wrappers for Codex CLI commands\n- Intelligent model selection (gpt-5 vs gpt-5-codex)\n- Sandbox mode helpers\n- Session management\n- **Always uses `codex exec`**\n\n## Usage Examples\n\n### Example 1: Generate AGENTS.md\n\n**User prompt**:\n```\nGenerate AGENTS.md for this project\n```\n\n**What happens**:\n1. Safety mechanism checks Codex CLI installed\n2. Checks CLAUDE.md exists (auto-runs /init if missing)\n3. Parses CLAUDE.md and project structure\n4. Generates AGENTS.md with file references\n5. Documents all skills with most relevant usage method\n\n**Output**: Complete AGENTS.md file in project root\n\n---\n\n### Example 2: Execute Codex Analysis Task\n\n**User prompt**:\n```\nUse Codex to analyze this codebase for security vulnerabilities\n```\n\n**What happens**:\n```python\nfrom codex_executor import CodexExecutor\n\nexecutor = CodexExecutor()\nresult = executor.exec_analysis(\n    \"Analyze this codebase for security vulnerabilities\",\n    model=\"gpt-5\"\n)\n```\n\n**Executes**:\n```bash\ncodex exec -m gpt-5 -s read-only \\\n  -c model_reasoning_effort=high \\\n  \"Analyze this codebase for security vulnerabilities\"\n```\n\n---\n\n### Example 3: Execute Codex Code Editing\n\n**User prompt**:\n```\nUse Codex to refactor main.py for better async patterns\n```\n\n**What happens**:\n```python\nexecutor = CodexExecutor()\nresult = executor.exec_edit(\n    \"Refactor main.py for better async patterns\",\n    model=\"gpt-5-codex\"\n)\n```\n\n**Executes**:\n```bash\ncodex exec -m gpt-5-codex -s workspace-write \\\n  -c model_reasoning_effort=high \\\n  \"Refactor main.py for better async patterns\"\n```\n\n---\n\n### Example 4: Resume Codex Session\n\n**User prompt**:\n```\nContinue the previous Codex session\n```\n\n**What happens**:\n```python\nexecutor = CodexExecutor()\nresult = executor.resume_session()\n```\n\n**Executes**:\n```bash\ncodex exec resume --last\n```\n\n## Best Practices\n\n### For AGENTS.md Generation\n1. **Always run on projects with CLAUDE.md** (or let auto-init create it)\n2. **Validate Codex CLI installed first**\n3. **Keep skills documented with most relevant method** (bash vs prompt)\n4. **Use reference-based approach** (no file duplication)\n\n### For Codex Execution\n1. **Use `codex exec` always** (never plain `codex` in Claude Code)\n2. **Choose correct model**:\n   - `gpt-5`: General reasoning, architecture, analysis\n   - `gpt-5-codex`: Code editing, specialized coding tasks\n3. **Choose correct sandbox**:\n   - `read-only`: Safe analysis (default)\n   - `workspace-write`: File modifications\n   - `danger-full-access`: Network access (rarely needed)\n4. **Enable search when needed** (`--search` flag)\n\n### For Skill Documentation\n1. **Prompt-only skills**: Reference in Codex prompts\n2. **Functional skills**: Execute Python scripts directly\n3. **Complex skills**: Show both methods\n4. **Always provide working examples**\n\n## Command Integration\n\nThis skill integrates with existing Claude Code commands:\n\n- **`/init`**: Auto-generates AGENTS.md after CLAUDE.md creation\n- **`/update-claude`**: Regenerates AGENTS.md when CLAUDE.md changes\n- **`/check-docs`**: Validates AGENTS.md exists and is in sync\n- **`/sync-agents-md`**: Manual AGENTS.md regeneration\n- **`/codex-exec <task>`**: Wrapper using codex_executor.py\n\n## Installation\n\n### Prerequisites\n1. **Codex CLI installed**:\n   ```bash\n   codex --version  # Should show v0.48.0 or higher\n   ```\n\n2. **Codex authenticated**:\n   ```bash\n   codex login\n   ```\n\n3. **Claude Code v1.0+**\n\n### Install Skill\n\n**Option 1: Copy to project**\n```bash\ncp -r generated-skills/codex-cli-bridge ~/.claude/skills/\n```\n\n**Option 2: Use from this repository**\n```bash\n# Skill auto-discovered when Claude Code loads this project\n```\n\n## Troubleshooting\n\n### Error: \"Codex CLI not found\"\n**Solution**: Install Codex CLI and ensure it's in PATH\n```bash\nwhich codex  # Should return path\ncodex --version  # Should work\n```\n\n### Error: \"CLAUDE.md not found\"\n**Solution**: Skill auto-runs `/init` with notification. If it fails:\n```bash\n# Manually run /init\n/init\n```\n\n### Error: \"stdout is not a terminal\"\n**Solution**: Always use `codex exec`, never plain `codex`\n```bash\n❌ codex -m gpt-5 \"task\"\n✅ codex exec -m gpt-5 \"task\"\n```\n\n### AGENTS.md Out of Sync\n**Solution**: Regenerate manually\n```bash\n/sync-agents-md\n```\n\n## References\n\n- **Codex CLI Docs**: `openai-codex-cli-instructions.md`\n- **Claude Skills Docs**: `claude-skills-instructions.md`\n- **Example Skills**: `claude-skills-examples/codex-cli-skill.md`\n- **AGENTS.md Spec**: https://agents.md/\n\n## Version\n\n**v1.0.0** - Initial release (2025-10-30)\n\n## License\n\nApache 2.0\n\n---\n\n**Created by**: Claude Code Skills Factory\n**Maintained for**: Cross-tool team collaboration (Claude Code ↔ Codex CLI)\n**Sync Status**: Reference-based bridge (one-way sync: CLAUDE.md → AGENTS.md)","author":"@alirezarezvani","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/codex-cli-bridge","license":"MIT","category":"writing","lang":"en","tokens":2256,"stars":0,"calls30d":2,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[{"path":"agents_md_generator.py","size":17868,"sha256":"d7dde3b095a182306a90c8101231d7e9193d2c5a3424ea9a3225531924b39ca4"},{"path":"bridge.py","size":7646,"sha256":"f0e616d71b94e1e3f13816203a82bc15651cb076f1b24b5cb8e2cb9d81f47553"},{"path":"CHANGELOG.md","size":5671,"sha256":"54fc4748895e04121b66800ec12c2c44ad9940680960b2bb624c9094295e1ed7"},{"path":"claude_parser.py","size":15276,"sha256":"152eaba3053c323a25c076340596ce9f62e05cabacdd8076a6bd6bd63f1febf7"},{"path":"codex_executor.py","size":13280,"sha256":"c297ffdb5260b421cc74cae5e09046019e71c3624f7e20726bd7e0a1c0e3e418"},{"path":"expected_output.json","size":4789,"sha256":"89281a4ca8ab15917afc7dec610e1e44e0701b266541b2c12e8f11b69c220a4a"},{"path":"HOW_TO_USE.md","size":10390,"sha256":"95a83bb488e062ba72ab3fb98bbdd1ae8f4061a0663578f6c79eef11ec54a5a1"},{"path":"INSTALL.md","size":10494,"sha256":"04aba3096a8275fb54eb70faeac6851c5d7c5b603ddf303f41042a6ccbe83c2b"},{"path":"package.sh","size":5956,"sha256":"a7b6acb5b66e69e49b4c96bf670c30a170159d704353c69034301e70069796ed"},{"path":"project_analyzer.py","size":11260,"sha256":"a0e60891f98e6afbd82fe5d365a92a2418219c18332542aaab904607f267c0a2"},{"path":"README.md","size":9750,"sha256":"618af9a38d621232e8815a35c205cda9a654b96a53e1a1bd1ee931a996714733"},{"path":"safety_mechanism.py","size":12243,"sha256":"94b3cf6ea7b9a280b86c8d62f4b18eaec768d40fb3e695b1e97b6d5352e7ec0b"},{"path":"sample_input.json","size":1559,"sha256":"6ec4a19d7d86e5df2a27195b83f313ac941715f418725f46cf4c3f757ce296eb"},{"path":"skill_documenter.py","size":9702,"sha256":"c2fad4a46c54057e3b664cea5c8e715466753e3d1decdad1d263ffd7f900f75a"}],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[{"code":"net.endpoints","kind":"exfiltration","excerpt":"agents.md, docs.claude.com, img.shields.io, keepachangelog.com","message":"bundled scripts reach 4 external host(s)","severity":"warn"}],"scannedAt":"2026-08-22","hasScripts":true,"networkEndpoints":["agents.md","docs.claude.com","img.shields.io","keepachangelog.com"]}}