> ## 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.

# Review gate

> Automatically block Claude from stopping until Codex clears the previous output.

## What the review gate does

When the review gate is enabled, a `Stop` 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.

<Warning>
  The review gate can create a long-running Claude/Codex loop and may drain usage limits quickly. Only enable it when you plan to actively monitor the session.
</Warning>

## Enabling and disabling

Use `/codex:setup` with a flag to toggle the review gate:

```bash theme={null}
/codex:setup --enable-review-gate
/codex:setup --disable-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 via `plugins/codex/hooks/hooks.json`:

* **`Stop`** — runs `stop-review-gate-hook.mjs`, which calls a Codex task review of the previous Claude response. If the review returns a `BLOCK` result, the stop is rejected and Claude continues the session.
* **`SessionStart`** and **`SessionEnd`** — run `session-lifecycle-hook.mjs` to manage session state, propagate environment variables, and clean up background jobs when the session ends.

The `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

<Note>
  Each stopped Claude turn triggers a Codex review, which adds latency. Reserve the review gate for sessions where thoroughness matters more than speed.
</Note>

## 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:

```bash theme={null}
/codex:setup
```

The setup report shows whether the review gate is enabled for the current workspace, along with overall Codex readiness status.