gemini-plugin-cc

A Claude Code plugin that integrates Google Gemini CLI as a subagent for code review, task delegation, and investigation.

Inspired by and modeled after openai/codex-plugin-cc. Credit to OpenAI for pioneering the Claude Code plugin pattern.

What You Get

• /gemini:review — Gemini code review against local git changes (read-only enforced)
• /gemini:adversarial-review — Pressure-test code by challenging design assumptions and finding failure modes
• /gemini:rescue — Delegate investigation, bug fix, or task to Gemini (foreground or background)
• /gemini:status — Show active and recent Gemini jobs
• /gemini:result — Retrieve completed job output
• /gemini:cancel — Cancel a running background job

Requirements

• Claude Code CLI, desktop app, or web app
• Node.js 18.18 or later
• Google account — Gemini CLI uses Google OAuth (free tier: 60 req/min, 1000 req/day) or a Gemini API key

Install

Add the marketplace in Claude Code:

/plugin marketplace add jiachengxu/gemini-plugin-cc

Install the plugin:

/plugin install gemini@gemini-plugin-cc

Reload plugins:

/reload-plugins

Then run:

/gemini:setup

/gemini:setup will check if Gemini CLI is installed, probe authentication, and validate capabilities. If Gemini CLI is missing, it will offer to install it for you.

If you prefer to install Gemini CLI yourself:

npm install -g @google/gemini-cli

If Gemini CLI is installed but not authenticated yet, run it interactively once to complete OAuth:

!gemini

After install, you should see:

• The slash commands listed above (/gemini:review, /gemini:rescue, etc.)
• The gemini:gemini-rescue subagent in /agents

Usage

/gemini:review

Runs a Gemini review on your current git changes. Automatically detects staged, unstaged, and untracked files. Review mode is read-only enforced — Gemini cannot modify your workspace.

/gemini:review
/gemini:review --model flash

/gemini:adversarial-review

Same as /gemini:review but with adversarial framing — challenges hidden assumptions, probes failure modes, and stress-tests edge cases.

/gemini:adversarial-review

/gemini:rescue

Delegate a task to Gemini. Runs in foreground by default, or in the background with --background.

/gemini:rescue investigate the auth bug in src/middleware.ts
/gemini:rescue --background refactor the error handling in lib/
/gemini:rescue --resume   # continue previous session

/gemini:status, /gemini:result, /gemini:cancel

Manage background jobs:

/gemini:status              # list all jobs
/gemini:status <job-id>     # detailed view
/gemini:result              # latest completed result
/gemini:result <job-id>     # specific job result
/gemini:cancel              # cancel latest running job

Acknowledgments

• openai/codex-plugin-cc — The reference implementation this project is modeled after. The plugin architecture, command structure, job tracking, and session lifecycle patterns are directly inspired by the Codex plugin.
• Google Gemini CLI — The underlying AI tool this plugin integrates.

License

Apache-2.0