{
  "markdown": "# Gemini for Claude\n\n**The missing Gemini plugin for Claude Code.** Review code, research the web, delegate tasks, and generate images -- all from Claude Code using Google's Gemini CLI.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-blueviolet)](https://docs.anthropic.com/en/docs/claude-code/plugins)\n[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-0.12+-4285F4?logo=google)](https://github.com/google-gemini/gemini-cli)\n\n---\n\n> **Why this exists:** The Codex plugin lets Claude Code delegate to OpenAI. This plugin does the same for Google Gemini -- plus web research, 1M token context, and image generation that Codex can't do.\n\n## What You Get\n\n| Command | What it does | Codex equivalent |\n|---------|-------------|-----------------|\n| `/gemini:setup` | Check CLI, auth, extensions | `/codex:setup` |\n| `/gemini:review` | Structured code review with JSON output | `/codex:review` |\n| `/gemini:adversarial` | Red-team security review with CVE search | `/codex:adversarial-review` |\n| `/gemini:rescue` | Delegate tasks to Gemini subagent | `/codex:rescue` |\n| `/gemini:status` | Check background job status | `/codex:status` |\n| `/gemini:result` | Retrieve completed job output | `/codex:result` |\n| `/gemini:cancel` | Cancel a running job | `/codex:cancel` |\n| **`/gemini:research`** | **Web-grounded research with Google Search** | *No equivalent* |\n| **`/gemini:image`** | **Generate images, diagrams, icons** | *No equivalent* |\n\n### Why Not Just Use Codex?\n\n| Capability | Codex | Gemini for Claude |\n|-----------|-------|-------------------|\n| Code review | Yes | Yes |\n| Web research | **No** | **Yes -- Google Search built in** |\n| Image generation | **No** | **Yes -- Nano Banana models** |\n| Context window | Large | **1M tokens** |\n| MCP support | **No** | **Yes** |\n| Free tier | Paid only | **60 RPM / 1,000 RPD free** |\n| Auth | OpenAI account | Google account (OAuth) or API key |\n\n## Quick Start\n\n### 1. Install the Gemini CLI\n\n```bash\nnpm install -g @google/gemini-cli\n```\n\n### 2. Authenticate\n\n```bash\ngemini  # Opens browser for Google OAuth -- no API key needed\n```\n\n### 3. Install the Plugin\n\nIn Claude Code, add this repo as a marketplace and install the plugin:\n\n```\n/plugin marketplace add philipvanlewis/gemini-for-claude\n/plugin install gemini@gemini-for-claude\n```\n\nRestart Claude Code so the new slash commands load.\n\n### 4. Verify\n\nIn Claude Code, run:\n\n```\n/gemini:setup\n```\n\n### 5. (Optional) Enable Image Generation\n\n```bash\ngemini extensions install https://github.com/gemini-cli-extensions/nanobanana\n```\n\n## Usage Examples\n\n### Code Review\n\n```\n/gemini:review\n```\n\nReturns structured JSON with verdict, findings, and suggestions. Works on staged changes, working tree, or full branch diff.\n\n### Adversarial Security Review\n\n```\n/gemini:adversarial focus on SQL injection and auth bypass\n```\n\nRed-team review that actively tries to break your code. Uses Google Search to check for known CVEs.\n\n### Web Research\n\n```\n/gemini:research what are the breaking changes in Next.js 15.2?\n```\n\nReturns findings with source URLs. Something Codex literally cannot do.\n\n### Delegate a Task\n\n```\n/gemini:rescue analyze the entire src/ directory for dead code and unused exports\n```\n\nLeverages Gemini's 1M token context to ingest entire codebases.\n\n### Generate Images\n\n```\n/gemini:image a clean architecture diagram showing microservices with message queue\n/gemini:image --icon a minimalist logo for a developer tool, blue gradient\n/gemini:image --diagram OAuth2 authorization code flow with PKCE\n```\n\n## Authentication\n\nThree methods, in order of recommendation:\n\n| Method | Setup | Cost | Best for |\n|--------|-------|------|----------|\n| **Google OAuth** | `gemini` (browser flow) | Free (60 RPM / 1K RPD) | Personal use |\n| **API Key** | `export GEMINI_API_KEY=\"...\"` | Pay-as-you-go | Higher limits |\n| **Vertex AI** | `export GOOGLE_CLOUD_PROJECT=\"...\"` | Enterprise billing | Production |\n\nOAuth uses your Google account subscription (including Gemini Advanced). No API key management required.\n\n## Architecture\n\n```\nClaude Code\n  │\n  ├─ /gemini:review ──────┐\n  ├─ /gemini:adversarial ──┤\n  ├─ /gemini:rescue ───────┤\n  ├─ /gemini:research ─────┤    ┌──────────────────────┐\n  ├─ /gemini:image ────────┼───►│ gemini-companion.mjs │\n  ├─ /gemini:status ───────┤    │                      │\n  ├─ /gemini:result ───────┤    │  - Job management    │\n  └─ /gemini:cancel ───────┘    │  - Git context       │\n                                │  - Output parsing    │\n                                │  - Error handling    │\n                                └──────────┬───────────┘\n                                           │\n                                           ▼\n                                  ┌─────────────────┐\n                                  │   Gemini CLI     │\n                                  │                  │\n                                  │  - Google Search │\n                                  │  - Code sandbox  │\n                                  │  - MCP support   │\n                                  │  - Extensions    │\n                                  │    (nanobanana)  │\n                                  └─────────────────┘\n```\n\n## Project Structure\n\nThe repo doubles as a single-plugin Claude Code marketplace. The marketplace manifest lives at the root, and the plugin itself lives in `plugin/`.\n\n```\ngemini-for-claude/\n├── .claude-plugin/\n│   └── marketplace.json       # Marketplace manifest (references ./plugin)\n├── plugin/\n│   ├── .claude-plugin/\n│   │   └── plugin.json        # Plugin metadata\n│   ├── agents/\n│   │   └── gemini-rescue.md   # Thin forwarding subagent\n│   ├── commands/\n│   │   ├── setup.md               # /gemini:setup\n│   │   ├── review.md              # /gemini:review\n│   │   ├── adversarial-review.md  # /gemini:adversarial\n│   │   ├── rescue.md              # /gemini:rescue\n│   │   ├── research.md            # /gemini:research\n│   │   ├── image.md               # /gemini:image\n│   │   ├── status.md              # /gemini:status\n│   │   ├── result.md              # /gemini:result\n│   │   └── cancel.md              # /gemini:cancel\n│   ├── skills/\n│   │   ├── gemini-prompting/       # Model-specific prompt guidance\n│   │   ├── gemini-result-handling/ # How to present Gemini output\n│   │   └── gemini-cli-runtime/     # Helper contract for CLI invocation\n│   ├── schemas/\n│   │   ├── review-output.schema.json   # Structured review output\n│   │   └── research-output.schema.json # Structured research output\n│   ├── scripts/\n│   │   └── gemini-companion.mjs   # Core runtime (~500 lines)\n│   └── hooks/\n│       └── hooks.json             # Lifecycle hooks\n├── .github/\n│   └── ISSUE_TEMPLATE/\n├── CONTRIBUTING.md\n├── LICENSE                    # MIT\n└── README.md                  # You are here\n```\n\n## How It Compares to Existing Plugins\n\n| Plugin | Stars | Job Mgmt | Structured Output | Research | Images | Full CLI |\n|--------|-------|----------|-------------------|----------|--------|---------|\n| [gemini-manager-skill](https://github.com/alchemiststudiosDOTai/claude-code-gemini-manager-skill) | 60 | No | No | No | No | No |\n| [gemini-search-plugin](https://github.com/d-oit/gemini-search-plugin) | 12 | No | No | Partial | No | No |\n| [cc-gemini-plugin](https://github.com/thepushkarp/cc-gemini-plugin) | 8 | No | No | No | No | Partial |\n| **gemini-for-claude** | -- | **Yes** | **Yes** | **Yes** | **Yes** | **Yes** |\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Issues and PRs welcome.\n\n## License\n\n[MIT](LICENSE) -- Element Zero Ltd\n\n---\n\nBuilt by [Element Zero](https://ezero.ai) -- AI automation for the real world.\n",
  "bytes": 7777,
  "sha": "1091951b88869642524c84820f0e46bff8054098d36f8e8a46105c1f9bb5b659",
  "repo_slug": "philipvanlewis/gemini-for-claude",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_philipvanlewis_gemini_for_claude_gemini__ed14aaef/readme"
}