Gemini Gpt Hybrid

Gemini-GPT Hybrid

Multi-model orchestration subagents for Claude Code.

One model is rarely the right model for every task. Whole-codebase analysis wants a huge context window; a tight bug fix wants fast iteration. This repo packages that decision as a Claude Code subagent: it reads the scope of your request, delegates to Gemini or GPT accordingly, and routes the result back through Claude before anything reaches your codebase.

How routing works

Installation

Prerequisites

- Claude Code
- Gemini CLI — npm install -g @google/gemini-cli
- Cursor Agent (for GPT integration)
- WSL, if you're on Windows

Setup

Verify with ls ~/.claude/agents/ — you should see both agent files.

Usage

Mention the agent in a Claude Code conversation:

Large scope — delegates to Gemini.

Narrow scope — delegates to GPT.

Mixed scope — uses both, in sequence.

The two agents

Both live in agents/. They differ in one thing: who is allowed to write to your files.

Soft — gemini-gpt-hybrid-soft.md

External models analyze; Claude writes all code. Gemini and GPT never touch your files directly, so their output can't break anything on its own, and every change goes through Claude's review and your existing coding standards.

Use for production code, critical systems, and anywhere a bad write is expensive.

Hard — gemini-gpt-hybrid-hard.md

External models modify your codebase directly. Much faster, and correspondingly riskier — autonomous generation and sweeping refactors happen without a Claude gate in front of the write.

Use for prototypes, experiments, and throwaway code. Commit first:
Hard mode can overwrite work. A clean commit beforehand is the only reliable rollback.

Choosing between them

A longer decision walkthrough lives in AGENT_SELECTION_GUIDE.md.

Review pass

In soft mode,…