Gemini

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 abiswas97/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 <pro|flash|pro-3|flash-3>.
/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

If omitted, defaults to gemini-2.5-flash. Any concrete model name (e.g. gemini-3.1-pro-preview) is passed through as-is.

Review Gate

When enabled (/gemini:setup --enable-review-gate), the plugin runs a targeted Gemini review on Claude's response before stopping. If issues are found, the stop is blocked so Claude can address them first.

[!WARNING] The review gate can create a long-running Claude/Gemini loop. Only enable it when actively monitoring the session.

Development

pnpm test        # run tests
pnpm run ci      # type check + lint + test
pnpm run lint:fix  # auto-fix lint issues

Project Structure

plugins/gemini/
├── .claude-plugin/plugin.json    # Plugin metadata
├── agents/                       # Gemini rescue subagent
├── commands/                     # Slash commands (.md)
├── hooks/                        # Session lifecycle + review gate hooks
├── prompts/                      # Prompt templates
├── schemas/                      # Output JSON schemas (review, errors)
├── scripts/                      # Companion CLI + runtime modules
└── skills/                       # Claude Code skills

License

Apache 2.0 — see LICENSE.