Documentation Index
Fetch the complete documentation index at: https://mintlify.com/openai/codex-plugin-cc/llms.txt
Use this file to discover all available pages before exploring further.
What the review gate does
When the review gate is enabled, aStop hook runs a targeted Codex review of Claude’s most recent response each time Claude tries to stop. If that review finds issues, the stop is blocked so Claude can address them before finishing the turn.
Enabling and disabling
Use/codex:setup with a flag to toggle the review gate:
Scope
The review gate setting is stored per project (workspace root). Enabling it in one project does not affect other projects.How the hook works
The plugin registers hooks viaplugins/codex/hooks/hooks.json:
Stop— runsstop-review-gate-hook.mjs, which calls a Codex task review of the previous Claude response. If the review returns aBLOCKresult, the stop is rejected and Claude continues the session.SessionStartandSessionEnd— runsession-lifecycle-hook.mjsto manage session state, propagate environment variables, and clean up background jobs when the session ends.
Stop hook has a 15-minute timeout. If the Codex review does not complete in time, the stop is blocked with an error message and you can run /codex:review --wait manually.
When to use it
The review gate works best when:- You are approaching a shipping decision and want every Claude response automatically reviewed before it finalizes
- You are in a code-heavy session where catching issues early matters more than speed
Each stopped Claude turn triggers a Codex review, which adds latency. Reserve the review gate for sessions where thoroughness matters more than speed.
Checking the current state
Run/codex:setup without any flags to see a setup report that includes whether the review gate is currently enabled for the current project: