Gemini plugin for Claude Code
Run Gemini from inside Claude Code for code reviews and delegated tasks.
This plugin lets Claude Code users reach Gemini without leaving their workflow. It adapts codex-plugin-cc to Gemini CLI's runtime model.
What You Get
/gemini:review — read-only Gemini review/gemini:adversarial-review — steerable challenge review/gemini:rescue — delegate tasks to Gemini through the gemini:gemini-rescue subagent/gemini:setup — verify the local Gemini CLI is installed and authenticated
Requirements
- Google account (free tier available) or
GEMINI_API_KEY.
- Node.js 18.18 or later
Install
Add the marketplace in Claude Code:
/plugin marketplace add contrapuntal/gemini-plugin-cc
Install the plugin:
/plugin install gemini@google-gemini
Reload plugins:
/reload-plugins
Then run:
/gemini:setup
/gemini:setup reports whether Gemini is ready. If Gemini is missing and npm is available, it offers to install it.
To install Gemini yourself:
npm install -g @google/gemini-cli
If Gemini is installed but not signed in:
!gemini
Sign in with your Google account inside the interactive REPL (or set GEMINI_API_KEY in your environment), then exit.
After install, you should see:
- the slash commands listed below
- the
gemini:gemini-rescue subagent in /agents
Usage
/gemini:review
Runs a Gemini review on your current work. Output is markdown organized by severity (Critical / High / Medium / Nits).
[!NOTE]
Multi-file reviews can take a while. Use background mode for anything larger than ~2 files.
Use it to review:
- your current uncommitted changes
- your branch against a base branch like
main
Pass --base <ref> for branch review. Also supports --wait and --background. Read-only and not steerable. To challenge a specific decision or risk area, use /gemini:adversarial-review.
/gemini:review
/gemini:review --base main
/gemini:review --background
This command never edits files.
/gemini:adversarial-review
A steerable review that challenges the chosen implementation and design. Uses the same review-target selection as /gemini:review.
Supports --base <ref>, --wait, --background, and free-form focus text after the flags.
/gemini:adversarial-review
/gemini:adversarial-review --base main challenge whether this caching design is right
/gemini:adversarial-review --background look for race conditions in the retry logic
This command never edits files.
/gemini:rescue
Hands a task to Gemini through the gemini:gemini-rescue subagent. Read-only by default — Gemini analyzes and proposes; Claude or you apply the change. Pass --write to let Gemini edit files directly via Gemini's --yolo mode.
Use it to have Gemini:
- analyze a large diff or codebase region (Gemini's 1M-token context shines here)
- give a second opinion on an approach Claude proposed
- investigate a bug or run an analysis pass
/gemini:rescue investigate why the build is failing in CI
/gemini:rescue --model pro analyze the entire src/ directory for race conditions
/gemini:rescue --write fix the failing test with the smallest safe patch
/gemini:rescue --background trace every caller of this function across the repo
Or just ask:
Ask Gemini to walk through the auth middleware and find anything that breaks under partial failure.
Notes:
- Read-only by default. Add
--write to let Gemini edit.
- Model aliases:
pro → gemini-2.5-pro, flash → gemini-2.5-flash.
--background runs the rescue as a Claude Code background bash task; output appears in chat when Gemini finishes.
/gemini:setup
Checks whether Gemini is installed and authenticated. If Gemini is missing and npm is available, it offers to install it.
/gemini:setup
How it works
The plugin invokes Gemini in non-interactive mode (gemini --prompt "...") with a fixed approval mode:
- Read-only paths (
/gemini:review, /gemini:adversarial-review, /gemini:rescue without --write) use --approval-mode plan, so the run cannot hang on an interactive approval prompt and Gemini cannot modify the workspace.
- Write path (
/gemini:rescue --write) uses --approval-mode yolo (equivalent to --yolo). Gemini auto-approves all tools, including shell commands.
Model selection
