naluforge-gemini

Gemini CLI Plugin for Claude Code

A Claude Code plugin that integrates Gemini CLI as a complementary AI engine. Use Gemini alongside Claude for tasks that benefit from a 1M-token context window, live Google Search, multimodal file processing, Google Workspace automation, and Python-based data analysis.

Why Use Both?

Claude Code excels at precise code generation, multi-file refactoring, and deep tool integration. Gemini complements it with capabilities Claude doesn't have:

Capability	Claude Code	Gemini via Plugin
Code generation & refactoring	Strong	Adequate
Video/audio analysis	No	Native multimodal
Google Workspace (Gmail, Docs, Sheets)	No	Native integration
Python code execution with charts	No	Built-in sandbox

The plugin routes tasks to the right engine automatically via the Gemini router agent, or you can invoke specific commands directly.

Prerequisites

• Claude Code installed and working
• Gemini CLI v0.11.0+ installed and authenticated
• Node.js 20+

# Install Gemini CLI
npm install -g @google/gemini-cli

# Authenticate
gemini auth login

Installation

# From GitHub (recommended)
claude plugin marketplace add NaluForge/geminicli-cc-plugin
claude plugin install gemini

# From local path (development)
claude plugin marketplace add /path/to/geminicli-cc-plugin
claude plugin install gemini

After installing, restart your Claude Code session. The plugin validates Gemini CLI availability on startup and shows a warning if it's not found.

Architecture

Claude Code Session
    |
    |-- /gemini-* commands ---------> Command definitions (commands/*.md)
    |                                    |
    |-- Gemini router agent ----------> Auto-routing logic (agents/gemini.md)
    |                                    |
    |-- Skills (auto-activated) -----> Context-aware guidance (skills/*)
    |                                    |
    +-- MCP Server (stdio) ----------> gemini_execute, gemini_resume,
         |                             gemini_status, gemini_sessions,
         |                             gemini_session_delete
         |
         +-- Gemini CLI (subprocess)
              |
              +-- Gemini API (pro / flash / flash-lite)

How it works:

1. Commands define slash commands (/gemini, /gemini-analyze, etc.) that instruct Claude how to use Gemini for specific task types
2. The router agent automatically identifies tasks that benefit from Gemini and dispatches them without manual command invocation
3. Skills activate contextually to guide Claude on model selection, timeout tuning, and prompt structuring
4. The MCP server bridges Claude Code to the Gemini CLI subprocess, managing sessions, streaming results, and handling errors
5. Session management tracks execution history so conversations can be resumed

Commands

/gemini <prompt> — General purpose

Send any prompt to Gemini. Good for one-off tasks that don't fit a specific category.

/gemini Explain the trade-offs between event sourcing and CRUD for our order system

/gemini-analyze <prompt> [paths=...] — Large codebase analysis

Analyze entire repositories or large codebases that exceed Claude's context window. Supports up to 1M tokens of context.

/gemini-analyze Map the dependency graph and identify circular dependencies paths=src/

/gemini-analyze Audit this repository for security vulnerabilities and outdated patterns

/gemini-search <query> — Web-grounded research

Research current information using Google Search grounding. Ideal for checking latest versions, security advisories, and documentation updates.

/gemini-search What are the breaking changes in Next.js 15?

/gemini-search Are there any active CVEs for OpenSSL 3.x released after January 2026?

/gemini-workspace <task> — Google Workspace

Automate Gmail, Google Docs, Sheets, Calendar, and Drive operations.

/gemini-workspace Summarize unread emails from the engineering team this week

/gemini-workspace Create a Google Doc with meeting notes from today's standup

/gemini-media <prompt> [files=...] — Multimodal processing

Analyze video, audio, images, and PDFs directly.

/gemini-media Transcribe this meeting recording files=recordings/standup-2026-04-02.mp4

/gemini-media Extract all tables from this PDF and convert to markdown files=docs/report.pdf

/gemini-data <prompt> [files=...] — Data analysis

Run Python-based data analysis with chart generation in Gemini's sandbox.

/gemini-data Analyze sales trends and generate a monthly revenue chart files=data/sales.csv

/gemini-data Find correlations between response time and error rate files=logs/metrics.json