Gemini plugin for Claude Code

Use Gemini from inside Claude Code for code reviews or to delegate tasks to Gemini.

Based on openai/codex-plugin-cc, adapted for the Gemini CLI. Also adds /gemini:task for direct task delegation.

What You Get

• /gemini:review for a normal read-only Gemini review
• /gemini:adversarial-review for a steerable challenge review
• /gemini:rescue, /gemini:status, /gemini:result, and /gemini:cancel to delegate work and manage background jobs
• /gemini:setup to verify Gemini CLI is ready and manage the review gate
• /gemini:task for quick one-off task delegation

Requirements

• Gemini CLI installed and authenticated — install guide
• Node.js 18.18 or later
• Google API key or Application Default Credentials — create an API key or run gcloud auth application-default login

Install

Add the marketplace in Claude Code:

/plugin marketplace add bonboncinnabon/gemini-plugin-cc

Install the plugin:

/plugin install gemini@abiswas97-gemini

Reload plugins:

/reload-plugins

Then run:

/gemini:setup

/gemini:setup will tell you whether Gemini is ready. If Gemini is missing, refer to the Gemini CLI installation guide.

If Gemini is installed but not authenticated, set up your credentials:

!gcloud auth application-default login

Or set the GOOGLE_API_KEY environment variable with a key from AI Studio.

After install, you should see:

• the slash commands listed below
• the gemini:gemini-rescue subagent in /agents

Configuration

Variable	Purpose
GOOGLE_API_KEY	API key from AI Studio. Alternative to gcloud auth application-default login.
GEMINI_ACP_INIT_TIMEOUT_MS	Override the 30s ACP initialize timeout. Bump it if Gemini CLI cold-start is slow on your machine (e.g. Homebrew installs that fall back to a file-based keychain).

Commands

Command	Description
/gemini:review	Code review on current work or branch. Supports --wait, --background, --base <ref>.
/gemini:adversarial-review	Challenges design choices, not just bugs. Same flags as review plus custom focus text.
/gemini:rescue	Delegate a task to Gemini via subagent. Supports --background, --resume, --fresh, --model .
/gemini:task	Quick one-off task delegation. Supports --background, --model.
/gemini:status	Show running and recent jobs.
/gemini:result	Show output for a finished job. Includes session ID for gemini resume.
/gemini:cancel	Cancel an active background job.
/gemini:setup	Check Gemini CLI readiness. Toggle review gate with --enable-review-gate / --disable-review-gate.

Typical Flows

# Review before shipping
/gemini:review --background
/gemini:status
/gemini:result

# Hand a problem to Gemini
/gemini:rescue investigate why the build is failing in CI

# Challenge your design
/gemini:adversarial-review --base main question the caching strategy

Model Selection

The --model flag accepts shortcuts or full model names:

• flash → gemini-2.5-flash (default)
• pro → gemini-2.5-pro
• flash-3 → gemini-3-flash-preview
• pro-3 → gemini-3-pro-preview