From codex-debugger
Verify Codex availability and configuration for codex-debugger plugin
npx claudepluginhub it-bens/claude-code-pluginsYou are checking if OpenAI Codex is properly configured and available for the codex-debugger plugin. Run these verification steps in sequence: ## Step 1: Check Codex CLI Installation Use Bash to check if the Codex CLI is installed: If not found, inform the user they need to install it: ## Step 2: Check Codex CLI Version If installed, check the version: Recommend updating if version is old (known issues with conversationId in older versions): ## Step 3: Verify MCP Server Registration Check if the codex MCP server is registered with Claude Code by attempting to use the `mcp__code...
/preflightChecks Codex connectivity, authentication, and available models. Displays status report, model tables, error fixes, and setup verdict.
/setupChecks local Codex CLI readiness, prompts to install if unavailable via npm, and optionally toggles stop-time review gate.
/doctorPerforms preflight diagnostic on claudex: verifies bash, codex CLI, state directory, plugin file integrity, and hook fail-open. Exit 0 if pass, 1 if fail.
/doctorDiagnoses pro-workflow and Claude Code setup health by checking installations, hooks functionality, git safety, context usage, CLAUDE.md size, git status, and settings.
/setupConfigures Codex (GPT) or Gemini as MCP servers for claude-delegator, installs orchestration rules to ~/.claude/rules/, and verifies setup.
/doctorVerifies CodeSensei plugin installation health via bash script, checks dependencies and config, shows profile stats, local files, issues, and next steps.
Share bugs, ideas, or general feedback.
You are checking if OpenAI Codex is properly configured and available for the codex-debugger plugin.
Run these verification steps in sequence:
Use Bash to check if the Codex CLI is installed:
which codex
If not found, inform the user they need to install it:
npm install -g @openai/codex
# or
brew install codex
If installed, check the version:
codex --version
Recommend updating if version is old (known issues with conversationId in older versions):
npm update -g @openai/codex
Check if the codex MCP server is registered with Claude Code by attempting to use the mcp__codex__codex tool with a minimal test prompt.
Call the tool with this exact configuration:
{
"prompt": "Test connection. Reply with 'OK' if you receive this.",
"model": "gpt-5",
"approval-policy": "never"
}
If the tool is not available or fails:
If the MCP call failed with authentication errors, the user needs to authenticate:
codex login
Codex authentication is required (typically included with ChatGPT Plus/Pro/Team subscriptions).
Provide a clear summary in this format:
Codex Pre-Flight Check Results
==============================
✓ Codex CLI: Installed (version X.X.X)
✓ MCP Server: Registered and accessible
✓ Authentication: Valid
✓ API Access: Codex available
Status: Ready for use
The codex-debugger plugin is fully operational.
Or if issues found:
Codex Pre-Flight Check Results
==============================
✗ Codex CLI: Not found
→ Run: npm install -g @openai/codex
⚠ MCP Server: Not registered
→ Restart Claude Code to load the MCP server
✗ Authentication: Not configured
→ Run: codex login
Status: Setup required
Follow the troubleshooting steps above, then run /codex-check again.
Include specific troubleshooting guidance based on which checks failed.
codex loginFor more details, see: plugins/codex-debugger/README.md