openai-codex

Codex Expert Plugin (Oracle Pattern)

Claude Code plugin that lets Claude ask Codex (OpenAI's GPT CLI) for a second opinion when stuck.

How It Works

When Claude is stuck after multiple failed attempts, it can consult Codex for a fresh perspective. Claude then synthesizes the response with its own knowledge rather than just parroting the output.

When Claude Will Consult Codex

• Stuck after 2+ failed attempts at same problem
• Architecture decisions with multiple valid paths
• Security concerns needing second opinion
• Unfamiliar domain where GPT training might help

Prerequisites

npm install -g @openai/codex
codex login

Installation

# Via slash command (in Claude Code)
/plugin install /path/to/openai-codex

# Or via CLI
claude plugin install /path/to/openai-codex

Scope options:

• --scope user (default) - available in all projects
• --scope project - shared with team
• --scope local - project-specific, gitignored

Commands

• /openai-codex:ask <question> - Ask Codex with properly framed context
• /openai-codex:status - Check if Codex CLI is installed

Agents

• codex-oracle - Haiku subagent for parent agents to delegate codex consultations. Takes context bundle, frames prompt, calls codex, waits 1-20 min, returns structured analysis.

Usage Example

Claude trying to fix a tricky bug:

1. Claude tries fix A → fails
2. Claude tries fix B → fails
3. Claude: "I've tried two approaches without success. Let me consult Codex for a second opinion."
4. Claude runs: codex -r high "debugging question with context"
5. Claude synthesizes response: "After consulting Codex, combined with my analysis, the issue appears to be..."