codex cli bridge

AI Community

Skill notes

Purpose

This skill creates a comprehensive bridge between Claude Code and OpenAI's Codex CLI, enabling seamless interoperability through: Documentation Translation: Converts CLAUDE.md → AGENTS.md (reference-based, no file duplication) Execution Helpers: Python wrappers for Codex CLI commands (always uses codex exec) Skill Documentation: Makes Claude Skills accessible to Codex CLI users

1. CLAUDE.md → AGENTS.md Generation

Parses CLAUDE.md and project structure Scans .claude/skills/, .claude/agents/, documentation/ folders Generates comprehensive AGENTS.md with file path references Reference-based: No file duplication, only links to existing files Documents Skills with most relevant usage method (bash scripts vs prompt references)

2. Safety Mechanism

Auto-checks Codex CLI installation (codex --version) Auto-runs /init if CLAUDE.md missing (with user notification) Validates authentication and environment User-friendly error messages

3. Codex CLI Execution Helpers

exec_analysis() - Read-only analysis tasks (gpt-5, read-only sandbox) exec_edit() - Code editing tasks (gpt-5-codex, workspace-write) exec_with_search() - Web search-enabled tasks resume_session() - Continue last Codex session Always uses codex exec (never plain codex - critical for Claude Code)

4. Skill Documentation for Codex CLI

Prompt-only skills: Show how to reference in Codex prompts Functional skills: Show how to execute Python scripts directly Complex skills: Show both methods Includes proper codex exec command syntax Model selection guidance (gpt-5 vs gpt-5-codex)

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
AI
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@tomevault-io · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
Python
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview codex-cli-bridge.preview
# Execution Helper Output

{
  "status": "success|error",
  "output": "Command output",
  "session_id": "uuid",
  "model_used": "gpt-5|gpt-5-codex",
  "command": "codex exec ..."
}

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.