g-cc
Use Gemini CLI from Claude Code to review code and delegate tasks. Works via Gemini CLI subscription — no API keys needed. Includes code rev
Open source Open in the app JSON README (API)
About
Use Gemini CLI from Claude Code to review code and delegate tasks. Works via Gemini CLI subscription — no API keys needed. Includes code review, adversarial challenge review, task delegation with background jobs, and an optional review gate that checks Claude's output before stopping.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- spyrae
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 2
- Forks
- 1
- Last push
- 2026-04-09T12:00:30Z
- Repository state
- ativo
- Language
- JavaScript
- License
- Apache-2.0
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
spyrae/gemini-plugin-cc/g-cc
README
<div align="center">
# gemini-plugin-cc
### Official Claude Code Plugin
**Use Gemini CLI from Claude Code** to review code and delegate tasks.
Works via Gemini CLI subscription — **no API keys needed**.
[](https://github.com/spyrae/gemini-plugin-cc)
[](LICENSE)
[](https://nodejs.org)
Published in the [Claude Code Plugin Marketplace](https://claude.ai/settings) — install directly from Claude Code.
</div>
---
## Install
```bash
# From Claude Code Plugin Marketplace (recommended)
/install spyrae/gemini-plugin-cc
# Or via CLI
/plugin marketplace add spyrae/gemini-plugin-cc
/plugin install gemini@spyrae-gemini
/reload-plugins
```
### Prerequisites
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed and authenticated
- Node.js 18+
- Claude Code
```bash
# Install Gemini CLI
npm install -g @google/gemini-cli
gemini auth login
```
## Commands
| Command | Description |
|---------|-------------|
| `/gemini:review` | Read-only code review via Gemini |
| `/gemini:adversarial-review` | Aggressive challenge review |
| `/gemini:rescue` | Delegate a coding task to Gemini |
| `/gemini:status` | Show job status |
| `/gemini:result` | Show job output |
| `/gemini:cancel` | Cancel active job |
| `/gemini:setup` | Check CLI + manage review gate |
### Examples
```
/gemini:review
/gemini:review --base main --scope "auth changes only"
/gemini:adversarial-review security implications of the new API
/gemini:rescue "fix the failing test in src/utils.test.ts"
/gemini:rescue "add input validation to the create-user endpoint" --background
/gemini:setup --enable-review-gate
```
## How It Works
```
Claude Code session
│
├─ /gemini:review ──── gemini-companion.mjs ──── gemini -p "..." -s
│ (read-only) (sandbox mode)
│
├─ /gemini:rescue ──── gemini-companion.mjs ──── gemini -p "..." -y
│ (write-capable) (auto-approve)
│
└─ [Stop hook] ─────── stop-review-gate ────── gemini -p "..." -s
(optional gate) (ALLOW / BLOCK)
```
### Review Gate
Optional safety net — Gemini reviews Claude's output before each stop:
```
/gemini:setup --enable-review-gate
```
Catches: auth bypasses, data loss risks, destructive commands, missing rollback safety.
## Architecture
```
plugins/gemini/
├── .claude-plugin/plugin.json # Plugin manifest
├── commands/ # Slash commands (markdown)
├── hooks/hooks.json # Session + review gate hooks
├── prompts/ # Prompt templates
├── schemas/ # Output JSON schemas
├── scripts/
│ ├── gemini-companion.mjs # Main CLI entry point
│ ├── session-lifecycle-hook.mjs # Session start/end
│ ├── stop-review-gate-hook.mjs # Review gate
│ └── lib/
│ ├── gemini.mjs # Gemini CLI wrapper
│ ├── state.mjs # Persistent state
│ ├── git.mjs # Git diff/context
│ ├── job-control.mjs # Job lifecycle
│ └── ... # Utils
├── skills/ # Internal skills
└── agents/ # Rescue subagent
```
### Key design decisions
- **No App Server** — Unlike the Codex plugin, Gemini CLI is invoked directly via `-p` flag. Simpler, no broker process needed.
- **Subscription auth** — Uses `gemini auth login` (Google account), no API keys.
- **Sandbox by default** — Reviews run in `-s` (sandbox) mode. Tasks run in `-y` (auto-approve) mode.
- **Background jobs** — Long tasks spawn detached processes, tracked by PID in state files.
## Configuration
State is stored per-project in `$CLAUDE_PLUGIN_DATA/state/<project-hash>/`:
- `state.json` — config + job list
- `jobs/` — individual job results and logs
## License
Apache-2.0
## Author
**Roman Belov** — [GitHub](https://github.com/spyrae) · [Blog](https://futurecraft.pro) · [LinkedIn](https://linkedin.com/in/romanblanc)