agy-bridge lets Claude Code offload file reads and git archaeology to Gemini

u/shahxaibb built `agy-bridge` after realizing their free Google AI Pro subscription — which bundles the Antigravity CLI (`agy`), a terminal-based Gemini interface with full tool access — had zero usage after several months, while Claude Code was consuming large amounts of tokens just to read files. An existing bridge tool (`claude-to-agy`) existed but had limitations: a single generic tool, no model selection, and no session continuity, meaning every follow-up resent the entire context. The author also discovered that `agy` itself silently falls back to a default model when passed an invalid model name, so `agy-bridge` validates model names against available `agy` models before running.

The bridge also includes model routing with availability checking and session continuity via `agy`'s conversation cache.

The resulting MCP server ships six purpose-built tools: `analyze_files` (Claude passes file paths, Gemini reads them, only the answer returns — file content never enters Claude's context), `deep_search` (git log/blame/grep archaeology across the whole repo), `web_lookup` (documentation and version lookups with source URLs), `adversarial_review` (a second opinion from a different model family on plans or diffs), `follow_up` (resumes an `agy` session by ID so follow-ups cost nearly nothing in extra context), and `delegate` (a raw escape hatch). The bridge also includes model routing with availability checking and session continuity via `agy`'s conversation cache.

Based on a few days of personal use — not a formal benchmark — the author estimates a ~1,000-line file question drops from ~10–15k tokens to ~500, a git archaeology query drops from ~30k+ tokens to a ~200-token answer with the commit hash, and overall context fills up 60–80% slower on analysis-heavy sessions. The project is written in TypeScript, MIT-licensed, ships with 32 tests, and is zero-install via `claude mcp add -s user agy-bridge npx -- -y agy-bridge`.

Key facts

1. 01Built by u/shahxaibb to put an unused free Google AI Pro subscription (which includes the Antigravity CLI `agy`) to work alongside Claude Code.
2. 02Ships six tools: `analyze_files`, `deep_search`, `web_lookup`, `adversarial_review`, `follow_up`, and `delegate`.
3. 03`analyze_files` passes only file paths to Gemini — file content never enters Claude's context, only the answer returns.
4. 04`follow_up` resumes an `agy` session by ID, so follow-up queries cost nearly zero extra context.
5. 05Token estimates from a few days of use: ~1,000-line file question drops from ~10–15k tokens to ~500; git archaeology drops from ~30k+ to ~200 tokens.
6. 06Author estimates context fills up 60–80% slower on analysis-heavy sessions.
7. 07TypeScript, MIT-licensed, 32 tests, zero-install via `npx`; `agy-bridge` validates model names because `agy` silently falls back to a default on bad model names.

Topics