codex-review
Code review via OpenAI Codex — review uncommitted changes, branches, or commits
/codex-review — Code Review via Codex
Get a code review from OpenAI's Codex CLI. Reviews uncommitted changes by default, or specify a branch or commit.
How to invoke
Run the wrapper script via Bash:
bash "${CLAUDE_PLUGIN_ROOT}/scripts/codex-run.sh" \
--prompt "Additional review instructions (optional)" \
--cwd "/path/to/repo" \
--mode review \
--review-target "uncommitted"
Then read the output file and present the review to the user.
Step-by-step workflow
- Determine what to review:
- No arguments → review uncommitted changes (
--review-target uncommitted) - User specifies a branch →
--review-target branch:branch-name - User specifies a commit →
--review-target commit:SHA
- No arguments → review uncommitted changes (
- Determine working directory. Must be inside a git repository.
- Build the prompt. The wrapper automatically fetches the diff and builds a review prompt. If the user provides extra instructions (e.g., "focus on security"), pass them as
--prompt. - Run codex-run.sh with
--mode reviewvia the Bash tool. - Read the output file using the Read tool.
- Present the review to the user. Frame it as "Codex's code review:" with clear sections.
- Add your own perspective if you see issues Codex missed, or agree with specific points.
Review targets
| Target | Flag | Example |
|---|---|---|
| Uncommitted changes | --review-target uncommitted | /codex-review |
| Branch diff | --review-target branch:NAME | /codex-review branch:feature/auth |
| Specific commit | --review-target commit:SHA | /codex-review commit:abc1234 |
Options
| Flag | Default | Description |
|---|---|---|
--prompt | "" | Additional instructions for the review |
--cwd | current dir | Path to the git repository |
--mode | — | Must be review for this skill |
--review-target | uncommitted | What to review |
--timeout | from config (120s) | Max seconds to wait |
--model | from config | Override the Codex model |
Example invocations
/codex-review— review all uncommitted changes/codex-review branch:main— review diff from main to HEAD/codex-review commit:a1b2c3d— review a specific commit/codex-review "focus on security and SQL injection"— review with extra instructions
Rules
- Always verify we're in a git repo before running. If not, tell the user.
- If no changes exist, tell the user there's nothing to review instead of sending an empty diff.
- Present both perspectives — show Codex's review, then add your own observations.
- Don't auto-apply suggestions — present findings and let the user decide what to fix.