gemini

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)

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 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: