https://github.com/abiswas97/gemini-plugin-cc
Use Gemini from Claude Code to review code or delegate tasks.
https://github.com/abiswas97/gemini-plugin-cc
claude-code claude-code-plugin code-review gemini gemini-cli
Last synced: 2 months ago
JSON representation
Use Gemini from Claude Code to review code or delegate tasks.
- Host: GitHub
- URL: https://github.com/abiswas97/gemini-plugin-cc
- Owner: abiswas97
- License: apache-2.0
- Created: 2026-03-31T07:01:19.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-31T13:34:22.000Z (3 months ago)
- Last Synced: 2026-03-31T14:35:38.141Z (3 months ago)
- Topics: claude-code, claude-code-plugin, code-review, gemini, gemini-cli
- Language: JavaScript
- Size: 147 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Notice: NOTICE
Awesome Lists containing this project
README
# 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`](https://github.com/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](https://developers.google.com/gemini-cli)
- **Node.js 18.18 or later**
- **Google API key** or Application Default Credentials — [create an API key](https://aistudio.google.com/app/apikey) or run `gcloud auth application-default login`
## Install
Add the marketplace in Claude Code:
```bash
/plugin marketplace add abiswas97/gemini-plugin-cc
```
Install the plugin:
```bash
/plugin install gemini@abiswas97-gemini
```
Reload plugins:
```bash
/reload-plugins
```
Then run:
```bash
/gemini:setup
```
`/gemini:setup` will tell you whether Gemini is ready. If Gemini is missing, refer to the [Gemini CLI installation guide](https://developers.google.com/gemini-cli).
If Gemini is installed but not authenticated, set up your credentials:
```bash
!gcloud auth application-default login
```
Or set the `GOOGLE_API_KEY` environment variable with a key from [AI Studio](https://aistudio.google.com/app/apikey).
After install, you should see:
- the slash commands listed below
- the `gemini:gemini-rescue` subagent in `/agents`
## Commands
| Command | Description |
|---------|-------------|
| `/gemini:review` | Code review on current work or branch. Supports `--wait`, `--background`, `--base `. |
| `/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
```bash
# 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
```bash
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](LICENSE).