Gemini Delegate — Development skill for Claude Code

gemini-delegate

[](LICENSE) [](https://python.org)

A Claude Code skill that delegates coding tasks to Google's Gemini CLI via the [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) -- structured JSON-RPC communication instead of shell subprocess piping.

What This Does

Claude Code sends prompts to Gemini CLI over a typed JSON-RPC channel. Gemini's responses come back as structured data -- tool calls, reasoning, and plans as JSON fields, not raw text to parse. File access is permission-controlled and path-scoped.

Features

• ACP transport -- JSON-RPC 2.0 over stdio via gemini --acp. No shell quoting hazards.
• Progress-Aware Heartbeat -- Uses a multi-tiered watchdog to handle long-running reasoning tasks without false timeouts.
• Structured output -- tool_calls, thoughts, plan, stop_reason as typed JSON fields.
• Permission control -- Read-only by default. Writes require explicit --approve-edits flag, scoped to workspace root.
• Path containment -- All file operations restricted to --cd directory. Traversal attempts rejected.
• Multi-turn sessions -- Session IDs auto-persisted per project using hashed identifiers for total isolation.
• Concurrency & Isolation -- Shredded session storage and explicit isolation flags for multi-agent workflows.
• Crash recovery -- Process crashes produce valid JSON output (stop_reason: "crash"), never raw tracebacks.
• Secure Defaults -- Enforces 0o700 on cache directories and 0o600 on temporary results.

Prerequisites

• Python >= 3.10
• Gemini CLI >= 0.36.0 with --acp support (install)
• Gemini API key configured for the Gemini CLI

Installation

# Clone
git clone https://github.com/YOUR_USERNAME/gemini-delegate.git

# Install the ACP SDK
pip inst