| name | codex-review-loop |
| description | Review a requested diff target with the Codex CLI, fix actionable issues, and rerun until no actionable findings remain. |
Codex Review Loop
Use the Codex CLI as the reviewer. You are the editor.
Use codex review - for every review pass. The prompt names the target and any
already-checked findings.
codex review - <<'PROMPT'
Review the current uncommitted changes.
Report only actionable issues.
PROMPT
Loop
- Run
codex review -. Name the target in the prompt: uncommitted changes, a
commit, a branch comparison, or another requested scope.
- Treat review findings as leads, not verdicts. Validate each finding yourself.
Actionable means a real issue in files this repo ships or uses.
- For a confirmed bug, add a failing test or a repro command before fixing it
when the repo has a practical place for one.
- Fix confirmed issues yourself.
- Re-run the relevant checks, such as tests, typecheck, or lint.
- Re-run
codex review - with the same target prompt and any already-checked
findings.
- Stop when there are no actionable findings left.
Repeated Findings
When a finding repeats after you validate it as not actionable, add it to the
next prompt. Restate the same target and include the exact Codex finding text
plus your validation result.
codex review - <<'PROMPT'
Review the changes introduced by commit <sha>.
Earlier review findings already checked:
- For each repeated finding, paste the exact Codex text and why your validation showed it is not actionable.
Report only new actionable issues.
PROMPT
Judgment
- Fix a finding only after you understand why it is real.
- Touch generated, vendored, or unrelated code only when the requested change
depends on it.
- Record false findings as non-actionable instead of changing code to satisfy
them.
Report the review command, fixes made, verification commands, and remaining
non-actionable findings if any.
