Skip to main content
plugin

gemini · arescope — Claude Code plugin: what it does, how to install

Runs Gemini CLI inside Claude Code for whole-codebase analysis across a 1M token context window, code reviews, and background task delegation.

Apache-2.0 ★ 6 updated 2026-04-05

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install gemini@claude-community
Open on GitHub

What gemini does

The plugin bridges Gemini CLI into Claude Code workflows. It hands repository analysis to Gemini by using its 1M token context window while Claude handles local edits. All commands pass through scripts/gemini-companion.mjs, relying purely on native Node.js modules without external npm packages.

Commands like /gemini:review, /gemini:challenge, and /gemini:consult support detached execution with --background. Job states and snapshots go to .gemini-tasks/state.json. A built-in Stop hook runs an automated review gate before Claude finishes, though leaving it on without supervision risks model ping-pong loops that drain API quotas.

Running the tool requires Node.js 18.0+, Git 2.0+, and @google/gemini-cli at version 0.36.0 or newer. You must also supply an AI Studio API key or authenticate with OAuth. Running /gemini:setup validates credentials and environment binaries.

What it helps with

  • audit repository architecture using a 1M token context
  • review code changes against the main branch
  • challenge architectural patterns and retry strategies
  • delegate background debugging tasks during build failures

Example prompts for the agent

  • /gemini:review --base main
  • /gemini:analyze Map the system architecture, key abstractions, and data flow
  • /gemini:consult --background investigate the flaky integration test

How to install gemini

Plugin marketplace

/plugin marketplace add anthropics/claude-plugins-community
/plugin install gemini@claude-community

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about gemini

How to install gemini in Claude Code?

Add the community registry via /plugin marketplace add anthropics/claude-plugins-community. Then install the plugin with /plugin install gemini@claude-community.

What does the gemini plugin do?

It lets Claude Code run Gemini CLI for code reviews and repository-wide analysis within a 1M token window. It also provides the gemini-consult subagent for delegated tasks.

What prerequisites are required?

You need Node.js 18.0+, Git 2.0+, and @google/gemini-cli version 0.36.0 or higher. You must also authenticate with an AI Studio API key or run gemini auth.

Source text

SKILL.md · Apache-2.0
# Gemini plugin for Claude Code

Use Gemini CLI from inside Claude Code for code reviews, whole-codebase analysis, or to delegate tasks.

This plugin is for Claude Code users who want to leverage Gemini's **1M token context window** alongside Claude Code's coding capabilities — giving you a "satellite view" of your codebase plus hands-on implementation power.

## Install

### From the personal plugin marketplace

> **Note:** This plugin is pending approval for the official Claude Code marketplace. Until then, install from the personal marketplace below.

**Step 1** — Add the marketplace registry:
```
/plugins marketplace add arescope/claude-plugins
```

**Step 2** — Install the Gemini plugin from the registry.

### From GitHub URL (direct)
```
/install-plugin https://github.com/arescope/gemini-plugin-cc
```

### From source (local development)
```bash
git clone https://github.com/arescope/gemini-plugin-cc.git
cd your-project
claude --plugin-dir /path/to/gemini-plugin-cc
```

### Prerequisites

1. Install Gemini CLI: `npm install -g @google/gemini-cli`
2. Authenticate: API key from [AI Studio](https://aistudio.google.com/apikey) or `gemini auth` for OAuth

Then verify:
```
/gemini:setup
```

## What You Get

- `/gemini:review` — code review with full codebase context
- `/gemini:challenge` — challenge review that questions design decisions
- `/gemini:analyze` — whole-codebase analysis (architecture, patterns, security, dependencies)
- `/gemini:consult` — consult Gemini on a task or delegate work
- `/gemini:setup` — check installation, auth, and manage the review gate
- `/gemini:status`, `/gemini:result`, `/gemini:cancel` — manage background jobs
- `gemini-consult` subagent — fires proactively for second opinions or delegation

## Architecture

All commands route through a single Node.js companion entry point (`scripts/gemini-companion.mjs`). Zero external dependencies — Node.js builtins only.

```
/gemini:review --background --base main
  → companion.mjs review --background --base main
    → resolves review target via git.mjs
    → loads prompt template via prompts.mjs
    → spawns detached task-worker
      → runs gemini CLI with structured output
      → parses JSON against schema
      → writes result to .gemini-tasks/state.json
```

### Module library (`scripts/lib/`)

| Module | Purpose |
|--------|---------|
| `args.mjs` | Parse slash-command arguments |
| `fs.mjs` | Filesystem helpers (stdin, JSON) |
| `gemini.mjs` | Gemini CLI wrapper — alias resolution, effort mapping, output parsing |
| `git.mjs` | Git helpers — repo check, review target, context collection |
| `job-control.mjs` | Job lifecycle — sort, resolve, snapshot |
| `process.mjs` | Process management — binary check, tree kill |
| `prompts.mjs` | Template loader with `{{VAR}}` interpolation |
| `render.mjs` | Output formatting — review results, status tables, setup reports |
| `state.mjs` | Centralized JSON state per workspace |
| `tracked-jobs.mjs` | Job execution with progress tracking and log files |
| `workspace.mjs` | Resolve workspace root from cwd |
| `types.d.ts` | TypeScript type definitions for all interfaces |

### Session lifecycle

Three hooks via `hooks/hooks.json`:
- **SessionStart** — propagates session ID to state
- **SessionEnd** — kills running jobs, cleans up session state
- **Stop** — smart review gate (skips turns that didn't make code edits)

## Requirements

| Requirement | Minimum | Recommended |
|-------------|---------|-------------|
| **Node.js** | 18.0+ | 22 LTS |
| **Claude Code** | Latest | Latest |
| **Gemini CLI** | 0.36.0+ | Latest |
| **Git** | 2.0+ | Latest |
| **OS** | Windows, macOS, Linux | — |

## Usage

### Review Before Shipping
```
/gemini:review --base main
```

### Challenge Your Design
```
/gemini:challenge --base main question the retry and error handling strategy
```

### Understand the Architecture
```
/gemini:analyze Map the system architecture, key abstractions, and data flow
```

### Delegate a Task
```
/gemini:consult investigate why the build is failing in CI
```

### Background Tasks
```
/gemini:consult --background investigate the flaky integration test
/gemini:status
/gemini:result
```

### Natural Language Delegation
Just ask Claude:
```
Ask Gemini to review these changes as an external peer
Have Gemini analyze the authentication flow across the entire codebase
```

## Review Gate (Stop Hook)

The review gate auto-reviews Claude's code changes before each stop — powered by Gemini. It skips turns that didn't make code edits.

```
/gemini:setup --enable-review-gate    # Enable
/gemini:setup --disable-review-gate   # Disable
```

Configuration is stored in `.gemini-tasks/state.json` via the companion runtime.

**Warning**: This can create a Claude/Gemini loop and may drain usage limits. Only enable when actively monitoring.

## Model Aliases

All commands accept short model names via `--model`:

| Alias | Model | Use case |
|-------|-------|----------|
| `flash`, `fast` | gemini-3-flash-preview | Fastest (default) |
| `pro`, `deep` | gemini-3.1-pro-preview | Most capable |
| `lite` | gemini-2.5-flash-lite | Cheapest |
| `flash-2` | gemini-2.5-flash | Previous gen fast |
| `pro-2` | gemini-2.5-pro | Previous gen capable |

```
/gemini:review --model pro
/gemini:consult --model flash --effort low quick check
```

## Effort Levels

Effort levels via `--effort` (reserved for future Gemini CLI support):

| Level | Budget |
|-------|--------|
| `low`, `l` | Light reasoning |
| `medium`, `med`, `m` | Standard |
| `high`, `h` | Deep reasoning |
| `xhigh`, `max` | Maximum |
| `none`, `off` | No thinking |
| `<number>` | Exact token count |

```
/gemini:analyze --effort high     # Deep reasoning
/gemini:consult --effort low       # Quick pass
```

## Internal Skills

Three internal skills guide agent behavior (not user-invocable):

| Skill | Purpose |
|-------|---------|
| `gemini-cli-runtime` | Contract for calling the companion from agents |
| `gemini-result-handling` | Rules for presenting Gemini output |
| `gemini-prompting` | Guidance for composing XML-tagged prompts |

Plus `guide` — a quick reference for all commands and options.

## Testing

```bash
# Node.js unit + integration tests (76 tests)
node --test tests/args.test.mjs tests/gemini.test.mjs tests/git.test.mjs \
  tests/process.test.mjs tests/render.test.mjs tests/state.test.mjs \
  tests/commands.test.mjs tests/runtime.test.mjs

# Structure validation (91 checks)
bash tests/test-plugin-structure.sh
```

## License

Apache-2.0

© arescope · Apache-2.0 · arescope/gemini-plugin-cc

Similar plugins

All plugins for Code review and refactoring →

gemini by other authors comes first.

gemini softaworks Delegates code reviews, plan checks, and large context processing to Gemini CLI. Triggers when context sizes exceed 200k tokens. ★ 2,707repo stars collaborating-with-gemini cnfjlhj collaborating-with-gemini connects Gemini CLI as a second opinion for diff inspection, bug analysis, and prototyping via a Python bridge. CX Codex +1 ★ 475repo stars gemini-agents Paweł Huryn The gemini-agents Claude Code skill connects Google's Antigravity CLI for coding and review tasks. Before each run, the agent explains the sign-in route and Google's position, then asks for consent. CX Codex +1 ★ 741repo stars gemini-watermark-remover GargantuaX gemini-watermark-remover removes visible Gemini watermarks from local image files using a bundled CLI script. Ideal for cleaning single pictures or whole directories right inside your agent workflow. CX Codex +1 12,900installs gemini-review davila7 gemini-review fetches Gemini Code Assist PR reviews from GitHub, categorizes feedback by severity, and turns it into an actionable task list for Claude Code. CX Codex +1 217installs anycap-gemini-omni-video-edit anycap-ai anycap-gemini-omni-video-edit — a skill for editing short videos with Gemini Omni Flash Preview through AnyCap: change one element, keep the rest. CX Codex +1 517installs phone-a-friend freibergergarcia phone-a-friend relays prompts and codebase context from Claude Code to external engines like Codex, Gemini, or Ollama. Useful for second opinions and multi-agent code reviews. ★ 10repo stars

Project sponsors

Companies that keep this analytics open