review

Start Codex Review Gate

Create a review gate that triggers Codex CLI review when you exit.

Parse Arguments

Arguments: $ARGUMENTS

Parse the following from arguments:

• FOCUS: Everything before the first -- flag (the review focus)
• --max-cycles: Number (default: 30) - maximum review cycles before auto-approve

Parsing rules:

1. Text before any -- flags is the review focus
2. Extract --max-cycles N if present (N must be a positive integer)
3. If no focus text provided, use the default focus

Examples:

• /codex-reviewer:review → default focus, max 30 cycles
• /codex-reviewer:review "focus on security vulnerabilities" → security review, max 30 cycles
• /codex-reviewer:review --max-cycles 3 → default focus, max 3 cycles
• /codex-reviewer:review "verify error handling" --max-cycles 10 → error handling review, max 10 cycles

Step 0: Check for Existing Gate

IMPORTANT: Before creating a new gate, check if an ACTIVE one already exists. The stop hook checks the current repo AND walks up through all parent superprojects, looking for the first ACTIVE gate. An inactive file does not block - continue checking parents:

# Check current repo and all ancestor superprojects for ACTIVE gate
DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
FOUND_ACTIVE=""
while [ -n "$DIR" ]; do
  STATE_FILE="$DIR/.claude/codex-review.local.md"
  if [ -f "$STATE_FILE" ] && grep -q "active: true" "$STATE_FILE"; then
    echo "Found ACTIVE state file at: $STATE_FILE"
    cat "$STATE_FILE"
    FOUND_ACTIVE="true"
    break
  fi
  # Check for parent superproject
  PARENT="$(git -C "$DIR" rev-parse --show-superproject-working-tree 2>/dev/null)"
  [ -z "$PARENT" ] && break
  DIR="$PARENT"
done
[ -z "$FOUND_ACTIVE" ] && echo "NO_ACTIVE_STATE_FILE"

If an ACTIVE state file exists (in current repo OR any ancestor):

The review gate is already active.

ALLOWED when gate is active:

• Regenerate the handoff file (/handoff) to capture your latest work
• The handoff file at ~/.handoffs/ can be updated freely