Codex Review
Execute code reviews via OpenAI Codex CLI with comprehensive analysis.
Prerequisites Check
Before proceeding, verify codex CLI availability:
which codex && codex --version
If codex is not found, inform the user and abort.
Workflow
Step 1: Collect Review Context
Run the context collection script or gather information manually:
# Using script
scripts/prepare_review_context.sh <target>
# Or manually for commits:
git log -1 --format="%H%n%s%n%b" <commit_id>
git diff-tree --no-commit-id --name-status -r <commit_id>
git show <commit_id>
# For PRs:
gh pr view <number> --json title,body,files
gh pr diff <number>
Step 2: Prepare Review Prompt
Structure the prompt with these sections:
以下のコードをレビューしてください。
## 1. 対象ファイル
- コミットID/PR: <id>
- 変更ファイル:
- <file1>
- <file2>
## 2. セッションのゴールと受入基準
<what success looks like>
## 3. 解決しようとした課題
<problems being addressed>
## 4. 成果と変更点
<summary of changes>
Step 3: Execute Codex Review
codex exec --sandbox read-only "<prepared_prompt>"
Critical notes:
- Always use
execsubcommand (not interactive mode) - Always use
--sandbox read-onlyfor safety - Command runs in background; may take 2-5 minutes
- Output includes thinking traces and final findings
Step 4: Interpret Results
Codex outputs contain:
thinking- reasoning traces (can be skipped)exec- commands executed by codexcodexor final text - actual review findings
Extract and summarize:
- Findings - issues found (or "None" if clean)
- Residual Risks - potential future problems
- Recommendations - actionable improvements
Review Perspectives
For comprehensive reviews, ensure codex examines these areas. See references/review-perspectives.md for detailed checklist.
| Category | Key Points |
|---|---|
| Correctness | Logic errors, edge cases, null handling |
| Security | Input validation, auth, secrets |
| Performance | N+1 queries, memory leaks, blocking ops |
| Maintainability | Duplication, naming, complexity |
| Testing | Coverage, isolation, assertions |
Error Handling
| Error | Cause | Solution |
|---|---|---|
stdout is not a terminal | Using interactive mode | Use codex exec instead |
command not found | codex not installed | Install via npm/brew |
| Timeout | Large diff or slow network | Increase timeout, split review |
| Auth error | Token expired | Run codex login |
Example Session
User: codex で最新コミットをレビューして
Claude:
1. Check codex availability: `which codex && codex --version`
2. Collect context:
- git log -1 --format="%H%n%s%n%b" HEAD
- git diff-tree --no-commit-id --name-status -r HEAD
- git show HEAD
3. Prepare prompt with 4 sections
4. Execute: codex exec --sandbox read-only "<prompt>"
5. Summarize findings for user
Scripts
scripts/prepare_review_context.sh <target>- Collects git context for commit/range/PR