gemini

Gemini Plugin for Claude Code

Use Google's Gemini CLI from inside Claude Code to review code or delegate tasks.

Origin: This plugin is a port of codex-plugin-cc, adapted from OpenAI's Codex App Server Protocol to Google's ACP (Agent Client Protocol). See Differences from codex-plugin-cc for details.

What You Get

Command	Purpose
/gemini:review	Read-only Gemini code review
/gemini:adversarial-review	Steerable challenge review
/gemini:rescue	Delegate a task to Gemini
/gemini:status	List active and recent jobs
/gemini:result	Show full output for a finished job
/gemini:cancel	Cancel an active background job
/gemini:setup	Check install, auth, and toggle review gate

Requirements

• Node.js 18.18 or later
• Google account or Gemini API key
  • Sign in with Google (free tier: 60 req/min, 1,000 req/day) or set GEMINI_API_KEY from AI Studio.

Install

1. Add the marketplace

claude /plugin marketplace add sakibsadmanshajib/gemini-plugin-cc

2. Install the plugin

claude /plugin install gemini@google-gemini

3. Reload plugins

In an active Claude Code session:

/reload-plugins

4. Run setup

/gemini:setup

If Gemini CLI is not installed, the plugin will offer to install it for you (npm install -g @google/gemini-cli).

If Gemini CLI is installed but not authenticated, run !gemini in Claude Code to authenticate interactively, or set GEMINI_API_KEY in your environment.

Usage

/gemini:review

Runs a Gemini review on your current work.

Note: Code review especially for multi-file changes might take a while. It's generally recommended to run it in the background.

Use it when you want:

• a review of your current uncommitted changes
• a review of your branch compared to a base branch like main

Use --base <ref> for branch review. It also supports --wait and --background. It is not steerable and does not take custom focus text. Use /gemini:adversarial-review when you want to challenge a specific decision or risk area.

Examples:

/gemini:review
/gemini:review --base main
/gemini:review --background

This command is read-only and will not perform any changes. When run in the background you can use /gemini:status to check on the progress and /gemini:cancel to cancel the ongoing task.

/gemini:adversarial-review

Runs a steerable review that questions the chosen implementation and design.

It can be used to pressure-test assumptions, tradeoffs, failure modes, and whether a different approach would have been safer or simpler.

It uses the same review target selection as /gemini:review, including --base <ref> for branch review. It also supports --wait and --background. Unlike /gemini:review, it can take extra focus text after the flags.

Use it when you want:

• a review before shipping that challenges the direction, not just the code details
• review focused on design choices, tradeoffs, hidden assumptions, and alternative approaches
• pressure-testing around specific risk areas like auth, data loss, rollback, race conditions, or reliability

Examples:

/gemini:adversarial-review
/gemini:adversarial-review --base main challenge whether this was the right caching and retry design
/gemini:adversarial-review --background look for race conditions and question the chosen approach

This command is read-only. It does not fix code.

/gemini:rescue

Hands a task to Gemini through the gemini:gemini-rescue subagent.

Use it when you want Gemini to:

• investigate a bug
• try a fix
• continue a previous Gemini task
• take a faster or cheaper pass with a smaller model

Note: Depending on the task and the model you choose these tasks might take a long time and it's generally recommended to force the task to be in the background or move the agent to the background.

It supports --background, --wait, --resume, and --fresh. If you omit --resume and --fresh, the plugin can offer to continue the latest rescue thread for this repo.

Examples:

/gemini:rescue investigate why the tests started failing
/gemini:rescue fix the failing test with the smallest safe patch
/gemini:rescue --resume apply the top fix from the last run
/gemini:rescue --model pro investigate the flaky integration test
/gemini:rescue --model flash fix the issue quickly
/gemini:rescue --background investigate the regression

You can also just ask for a task to be delegated to Gemini:

Ask Gemini to redesign the database connection to be more resilient.

Notes: