gemini-review

/gemini-review — Code Review via Gemini

Get a code review from Google's Gemini 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/gemini-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

1. Determine what to review:
2. No arguments → review uncommitted changes (--review-target uncommitted)
3. User specifies a branch → --review-target branch:branch-name
4. User specifies a commit → --review-target commit:SHA
5. Determine working directory. Must be inside a git repository.
6. 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.
7. Run gemini-run.sh with --mode review via the Bash tool.
8. Read the output file using the Read tool.
9. Present the review to the user. Frame it as "Gemini's code review:" with clear sections.
10. Add your own perspective if you see issues Gemini missed, or agree with specific points.

Review targets

| Target | Flag | Example | |--------|------|---------| | Uncommitted changes | --review-target uncommitted | /gemini-review | | Branch diff | --review-target branch:NAME | /gemini-review branch:feature/auth | | Specific commit | --review-target commit:SHA | /gemini-review commit:abc1234 |

Example invocations

• /gemini-review — review all uncommitted changes
• /gemini-review branch:main — review diff from main to HEAD
• /gemini-review commit:a1b2c3d — review a specific commit
• /gemini-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 Gemini's review, then add your own observations.
• Don't auto-apply suggestions — present findings and let the user decide what to fix.