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
/plugin marketplace add anthropics/claude-plugins-community
/plugin install gemini@claude-communityWhat 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-communityStep 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.