Codex plugin for Claude Code: review code and hand off tasks to Codex

• Codex reviews your uncommitted changes or branch, read-only

  Runs the same review as /review in Codex on your working tree, or on your branch versus --base <ref>. Supports --wait and --background. Takes no custom focus text and never edits code.

  Try: “/codex:review --base main”

  Runs code · /codex:review

• A review that challenges your design, tradeoffs and assumptions

  Same targets as /codex:review, but steerable: add focus text after the flags to pressure-test areas like auth, data loss, rollback or race conditions. Read-only.

  Try: “/codex:adversarial-review --background look for race conditions and question the chosen approach”

  Runs code · /codex:adversarial-review

• Hand a bug, fix or follow-up task to Codex

  Sends the task to the codex:codex-rescue subagent, which runs it in Codex. Supports --background, --wait, --resume, --fresh, --model and --effort. Codex can edit files in your workspace by default.

  Try: “/codex:rescue fix the failing test with the smallest safe patch”

  Runs code · /codex:rescue

• Turn this Claude Code session into a Codex thread you can resume

  Imports the current Claude Code transcript into Codex and prints a codex resume <session-id> command. --source points at another transcript under ~/.claude/projects.

  Try: “/codex:transfer”

  Runs code · /codex:transfer

• List running and recent Codex jobs for this repo

  Shows job ID, kind, status, phase and elapsed time for current and recent jobs, plus review-gate status. Pass a job ID for full detail.

  Try: “/codex:status task-abc123”

  Runs code · /codex:status

• Show the final output of a finished Codex job

  Prints the stored result with findings, file paths and line numbers, and the Codex session ID so you can reopen it with codex resume.

  Try: “/codex:result”

  Runs code · /codex:result

• Stop a running background Codex job

  Cancels the active background job, or the one whose ID you pass.

  Try: “/codex:cancel task-abc123”

  Runs code · /codex:cancel

• Check Codex is installed and signed in; toggle the review gate

  Reports whether Codex is ready. If Codex is missing and npm exists, it offers to run npm install -g @openai/codex. --enable-review-gate and --disable-review-gate turn the Stop hook review on or off.

  Try: “/codex:setup --enable-review-gate”

  Runs code · /codex:setup

• Subagent that forwards a task to Codex in one call

  Runs on the sonnet model with only Bash. Forwards your request to the Codex companion script once and returns Codex's output unchanged. Its description tells Claude to use it proactively when stuck, and it adds --write unless you ask for read-only.

  Try: “Ask Codex to redesign the database connection to be more resilient.”

  Runs code · codex:codex-rescue (subagent)

• Records session ID and transcript path for later commands

  Runs a local Node script (5 second timeout) that appends three env vars to Claude Code's env file. No network.

  Runs code · SessionStart hook

• Shuts down the Codex helper and this session's running jobs

  Runs a local Node script (5 second timeout) that tells the shared Codex app-server broker to shut down, kills this session's queued or running jobs and removes them from state.

  Runs code · SessionEnd hook

• Optional: Codex reviews Claude's last edits and can block stopping

  Runs on every turn end (900 second timeout). With the gate off it only notes running jobs. With it on, it runs a Codex task reviewing the previous turn's edits and blocks the stop if Codex answers BLOCK, fails or times out.

  Try: “/codex:setup --enable-review-gate”

  Runs code · Stop hook (review gate)

• Used by the assistant behind the scenes

  Internal rules for how the rescue subagent calls Codex

  Not user-invocable. Tells the subagent to make exactly one task call, map flags like --resume and spark, and default to write-capable runs.

  codex-cli-runtime (skill)

• Internal guide for writing tight prompts for Codex

  Not user-invocable. Lets the subagent rewrite your request into a structured, XML-tagged Codex prompt, with reference recipes and anti-patterns.

  gpt-5-4-prompting (skill)

• Internal rules for showing Codex output back to you

  Not user-invocable. Keeps findings ordered by severity with exact file paths, and tells Claude not to apply fixes from a review until you say which ones.

  codex-result-handling (skill)

Watch out for

• Rescue can edit your files by default

  The codex-rescue helper adds write access unless you ask for read-only work, so Claude can start an edit-capable Codex run you did not request. Say "read-only" or "diagnosis only" in the prompt. github.com

• Claude Code deny rules do not apply to Codex

  Codex reads and writes through its own sandbox, so Read and Edit deny rules in .claude/settings.json do not stop it. This is reported and still open. Do not rely on those rules to protect secrets. github.com

• Reviews send your code to OpenAI

  A review sends your diff and untracked text files to Codex, which calls OpenAI. An open report says adversarial review follows symlinks and can include files outside the repo. Keep secrets and links to other folders out of the repo you review. github.com

• Runs spend your Codex usage or API credit

  Each review and task counts against your Codex limits, or is billed at API rates if you sign in with an API key. Watch /codex:status for long jobs. learn.chatgpt.com

• Stop hook: the optional review gate can block Claude

  With the gate on, the Stop hook has Codex review each turn that edited code, for up to 15 minutes, and stops Claude from finishing if it finds issues. It can loop and use up limits. It is off by default. github.com

• SessionStart hook writes to Claude's env file

  It runs a local Node script (5 s timeout) that adds three variables to Claude Code's env file. No network calls. Open reports say it repeats on resume. github.com

• SessionEnd hook stops the helper and kills jobs

  It runs a local Node script (5 s timeout) that shuts down the Codex helper and kills this session's running Codex jobs. Finish or collect results before you close a session. github.com

• Setup can install a global npm package

  If Codex is missing and npm is present, /codex:setup asks once, then runs the Codex install. Say no if you install tools yourself. github.com

Security advisories

• CClaude CodeHas issues

Tap an app to see how to set it up and any known problems.

In their words