codeflash-agent/plugin/commands/codex-setup.md
2026-04-03 17:36:50 -05:00

1.1 KiB

description argument-hint allowed-tools
Check whether the local Codex CLI is ready and optionally toggle the stop-time review gate [--enable-review-gate|--disable-review-gate] Bash(node:*), Bash(npm:*), AskUserQuestion

Run:

node "${CLAUDE_PLUGIN_ROOT}/../vendor/codex/scripts/codex-companion.mjs" setup --json $ARGUMENTS

If the result says Codex is unavailable and npm is available:

  • Use AskUserQuestion exactly once to ask whether Claude should install Codex now.
  • Put the install option first and suffix it with (Recommended).
  • Use these two options:
    • Install Codex (Recommended)
    • Skip for now
  • If the user chooses install, run:
npm install -g @openai/codex
  • Then rerun:
node "${CLAUDE_PLUGIN_ROOT}/../vendor/codex/scripts/codex-companion.mjs" setup --json $ARGUMENTS

If Codex is already installed or npm is unavailable:

  • Do not ask about installation.

Output rules:

  • Present the final setup output to the user.
  • If installation was skipped, present the original setup output.
  • If Codex is installed but not authenticated, preserve the guidance to run !codex login.