Claude Code plugin that integrates Gemini CLI for long-context code exploration and analysis.

This plugin gives Claude Code access to Google Deepmind's Gemini CLI who's 1M token context window enables "satellite view" analysis - seeing your entire codebase at once rather than file-by-file.

Use cases:

• Whole-codebase architecture understanding - See all files simultaneously
• Cross-file security audits - Trace data flow across modules
• Refactoring impact analysis - Find all usages and dependencies
• Understanding unfamiliar large codebases - Rapid orientation
• Documentation generation - Synthesize README, API docs, architecture docs from full context

1. Install Gemini CLI

   npm install -g @google/gemini-cli # or brew install gemini

2. Authenticate

   gemini auth

3. Verify installation

   gemini "what is 2+2" --output-format text --approval-mode yolo

Install via Claude Code's plugin marketplace:

/plugin marketplace add thepushkarp/cc-gemini-plugin 

Or install directly from the repository:

/plugin install https://github.com/thepushkarp/cc-gemini-plugin 

# Simple query /gemini explain the architecture of this codebase # With specific model /gemini --model gemini-3-flash what does this function do # With directory context /gemini --dirs src,lib analyze the module structure # With file context /gemini --files "**/*.py" security audit focusing on injection vulnerabilities # Documentation generation /gemini --dirs src generate API documentation for all endpoints # Sandboxed execution /gemini --sandbox --dirs src analyze and test the build pipeline

Claude can automatically spawn the gemini-agent for deep exploration tasks. Just ask questions like:

• "Help me understand the architecture of this project"
• "Do a security audit of this codebase"
• "What would be affected if I refactor the auth module?"
• "How does the payment flow work end-to-end?"
• "Generate API documentation for this project"

For best results with Gemini:

1. Be direct - Skip pleasantries, state the task clearly
2. Be specific - "analyze auth module security" > "check security"
3. Set constraints - "Focus ONLY on X. Skip Y."
4. Request format - "Output as: file:line - issue - recommendation"

/gemini --dirs src Analyze all error handling paths. For each: file:line, error type, whether logged, whether recoverable. /gemini --files "**/*.py" Security audit. Focus ONLY on: SQL injection, command injection, path traversal. Skip style issues. /gemini --dirs src Generate API documentation. For each endpoint: method, path, parameters, response type, example usage.

/gemini check this code /gemini is there anything wrong

The plugin executes Gemini CLI in headless mode:

# Basic gemini "<PROMPT>" --output-format text --approval-mode yolo 2>&1 # With model gemini "<PROMPT>" -m gemini-3-flash --output-format text --approval-mode yolo 2>&1 # With directories gemini "<PROMPT>" --include-directories src,lib --output-format text --approval-mode yolo 2>&1 # With file context cat files | gemini "<PROMPT>" --output-format text --approval-mode yolo 2>&1 # With sandbox gemini "<PROMPT>" --sandbox --output-format text --approval-mode yolo 2>&1

• Whole-codebase architecture analysis
• Cross-file security audits
• Refactoring impact analysis
• Understanding unfamiliar codebases
• End-to-end flow tracing
• Documentation generation

• Quick single-file edits (use Claude)
• Interactive debugging (needs back-and-forth)
• Speed-critical simple tasks

cc-gemini-plugin/ ├── .claude-plugin/ │ └── plugin.json # Plugin manifest ├── agents/ │ └── gemini-agent.md # Autonomous agent ├── commands/ │ └── gemini.md # /gemini slash command ├── skills/ │ └── gemini/ │ └── SKILL.md # Usage guidance ├── .gitignore └── README.md 

MIT

thepushkarp