reviewing-code

Code Review with Codex

Use mcp__codex__spawn_agent for code review.

When to Use

• Review code quality and patterns
• Find potential bugs or edge cases
• Validate against best practices
• Check for security issues

Usage

{
  "prompt": "Review this code for [quality/bugs/security]: [code or file]"
}

Prompt Examples

• "Review for code quality and Go best practices: [code]"
• "Analyze for security vulnerabilities: [code]"
• "Review for performance issues: [code]"
• "Does this follow idiomatic patterns? [code]"

---

Gotchas

• Codex review is non-deterministic — same code with different invocations gets different priority orderings; pin model version when reproducibility matters.
• Codex doesn't see staged-but-uncommitted changes by default — pass them explicitly via --include-staged or piped diff.
• Diff-only review misses cross-file effects — a renamed function's callsite in another file isn't in the diff, so the rename's blast radius isn't surfaced.
• Review output ranks by Codex's internal severity heuristic — not by user-defined priority; re-rank manually for project-specific concerns.
• Whitespace-only diffs trigger reviews — pass --ignore-whitespace or you get noise.
• Large diffs (>500 LOC) get summarized, not reviewed line-by-line — split into focused reviews per file group.