codex

/codex — Peer AI via OpenAI Codex

You have access to OpenAI's Codex CLI as a peer AI. Use it to brainstorm, delegate tasks, get second opinions, or ask questions from a different AI perspective.

How to invoke

Run the wrapper script via Bash. IMPORTANT: Codex regularly takes 3-6 minutes for non-trivial tasks. You MUST set the Bash tool's timeout parameter to 420000 (7 minutes) to prevent Claude Code from killing the process before Codex finishes.

bash "${CLAUDE_PLUGIN_ROOT}/scripts/codex-run.sh" \
  --prompt "YOUR PROMPT HERE" \
  --cwd "/path/to/relevant/directory" \
  --mode exec

Then read the output file path it prints and present the results to the user.

Step-by-step workflow

1. Parse the user's request. The user says /codex "some prompt" or /codex followed by a question.
2. Determine the working directory. Default to the current project root. If the user references a specific repo or directory, use that.
3. Run codex-run.sh with --mode exec and the user's prompt via the Bash tool.
4. Read the output file using the Read tool. The script prints the output file path to stdout.
5. Show Codex's raw response directly. Use this format — show their actual words, don't paraphrase or summarize:

🔵 **Codex:**
> [their full response here, verbatim, as a blockquote]

1. Add your own take only if asked. If the user wants a comparison or synthesis, add it after Codex's response. Otherwise, let Codex's voice stand on its own.

Options

| Flag | Default | Description | |------|---------|-------------| | --prompt | (required) | The question or task for Codex | | --cwd | current dir | Working directory for Codex | | --mode | exec | Always exec for this skill | | --timeout | from config (360s) | Max seconds to wait | | --model | from config | Override the Codex model | | --sandbox | full-auto | Sandbox mode: full-auto or suggest |

Example invocations

• /codex "What's the best way to implement a rate limiter in Go?"
• /codex "Review this architecture: we have a React frontend calling a FastAPI backend with Redis caching"
• /codex "Write a bash script that finds duplicate files by hash"
• /codex "Debug this error: TypeError: Cannot read property 'map' of undefined"

Rules

• Always use --ephemeral and --full-auto — these are hardcoded in the wrapper, never override them.
• Never pass secrets or API keys in the prompt.
• Respect timeouts — if Codex times out, tell the user and suggest a simpler prompt.
• Frame the output clearly — the user should always know which AI produced which response.
• Don't modify files based on Codex's suggestions without user confirmation.