| name | codex-review |
| description | Ask the Codex CLI (gpt-5.5) for an independent code review of uncommitted changes, a branch diff, a commit, or a specific implementation. Use Codex as an independent reviewer when the user wants a second-pass review, or when a change is broad enough that another agent's perspective is useful. Codex reviews only — it does not edit. |
Codex Review
Codex (gpt-5.5) is an independent reviewer. Reach for it when the user wants a second-pass review, or when a change is broad enough that a separate model's perspective helps.
Workflow
- Identify the review target: uncommitted changes, base branch, commit SHA, PR checkout, or specific files.
- Create a temporary artifact directory for the Codex report.
- Run
codex review with a focused review prompt.
- Read Codex's report and verify important claims against the code before presenting them.
Use one of these command shapes:
ARTIFACT_DIR="$(mktemp -d "${TMPDIR:-/tmp}/codex-review.XXXXXX")"
REPORT="$ARTIFACT_DIR/report.md"
PROMPT="$ARTIFACT_DIR/prompt.md"
codex -C "$PWD" review --uncommitted - < "$PROMPT" > "$REPORT"
codex -C "$PWD" review --base main - < "$PROMPT" > "$REPORT"
codex -C "$PWD" review --commit <sha> - < "$PROMPT" > "$REPORT"
Review Prompt
Ask Codex to use a code-review stance:
Review these changes for bugs, regressions, missing tests, security issues, and requirement mismatches.
Prioritize findings over summary. For each finding include:
- severity
- file and line reference
- concrete failure mode
- suggested fix direction
Do not edit files. If there are no substantive findings, say so and name any residual test gaps.
Add task-specific context when useful: requirements, risky areas, expected behavior, relevant tests, or files Claude is unsure about.
Reporting Back
Before relaying a Codex finding, inspect the cited code or diff enough to decide whether the finding is real. In the user-facing response, separate confirmed issues from Codex suggestions you did not verify.
If Codex finds nothing, say that clearly and mention what review target it inspected.
If codex is not installed or the command fails, report the error and offer to review the changes directly instead.
