Claude Gemini Bridge

Claude-Gemini Bridge

🤖 **Intelligent integration between Claude Code and Google Gemini for large-scale code analysis**

The Claude-Gemini Bridge automatically delegates complex code analysis tasks from Claude Code to Google Gemini, combining Claude's reasoning capabilities with Gemini's large context processing power.

[](#testing) [](#license) [](#requirements)

🚀 Quick Start

# Clone and install for all projects in one simple process
git clone https://github.com/your-username/claude-gemini-bridge.git
cd claude-gemini-bridge
./install.sh

# IMPORTANT: Restart Claude Code to load the new hooks
# (Hooks are only loaded once at startup)

# Test the installation
./test/test-runner.sh

# Use Claude Code normally - large analyses will automatically use Gemini!
claude "analyze all Python files in this project"

Installation Details

The installer:

• ✅ Works in the current directory (no separate installation location)
• ✅ Automatically merges with existing Claude hooks in ~/.claude/settings.json
• ✅ Creates backups before making changes
• ✅ Tests all components during installation
• ✅ Provides uninstallation via ./uninstall.sh

📋 Table of Contents

• Architecture
• How It Works
• Installation
• Configuration
• Usage Examples
• Testing
• Troubleshooting
• Contributing

🏗️ Architecture

graph TB
    subgraph "Claude Code"
        CC[Claude Code CLI]
        TC[Tool Call]
    end
    
    subgraph "Claude-Gemini Bridge"
        HS[Hook System]
        DE[Decision Engine]
        PC[Path Converter]
        CH[Cache Layer]
    end
    
    subgraph "External APIs"
        GC[Gemini CLI]
        GA[Gemini API]
    end
    
    CC -->|PreToolUse Hook| HS
    HS --> PC
    PC --> DE
    DE -->|Delegate?| CH
    CH -->|Yes| GC
    GC --> GA
    GA -->|Analysis| CH
    CH -->|Response| HS

...