A Claude Code plugin that routes tasks to agy (Google Antigravity CLI), giving your Claude sessions access to Gemini 3.1/3.5, GPT-OSS 120B, and grounded web search with source citations.

Why

Independent review. A model reviewing its own output anchors on the reasoning it used to produce it. Gemini and GPT-OSS 120B — different companies, different training — catch different things. Not because Claude can't review code, but because it tends to miss what it already decided was right.

Current information with sources. Claude's training has a cutoff. When you need today's release notes, a pricing page, or a changelog with actual URLs, you need live web search — not a model's best guess.

A migration path off the Gemini CLI. On June 18, 2026, Google stops serving Gemini CLI requests for consumer tiers (AI Pro, Ultra, free Code Assist) and names the Antigravity CLI as the replacement. Frameworks like Claude Octopus and Metaswarm that shell out to a gemini binary break on that date. The included shim answers to the gemini name and routes the call through agy, so those tools keep working with no config changes.

How it works

The plugin has two parts.

agy-bridge is a shell script that wraps agy with type routing, per-type tool restrictions, prompt sanitization, and consistent exit codes. Each --type gets its own GEMINI.md written to a temporary working directory; agy reads it via --add-dir and treats those restrictions as binding. A search call can only use web tools. A review call can only read files. An implement call can read and write files but can't run shell commands. Prompts travel through stdin rather than command-line arguments, so they don't appear in ps or /proc/cmdline.

agy-delegate is a Claude Code skill that tells Claude when to reach for the bridge. It triggers on phrases like "search for", "latest", "ask Gemini", "second opinion". Claude picks the right --type, constructs the prompt, and pipes it through.

# How Claude calls it internally (you can run these directly too)
echo "dplyr 1.1.0 release notes" | agy-bridge --type search
echo "Review /path/to/api.py for correctness" | agy-bridge --type review

Type routing

--type	Model	What it can do
search	Gemini 3.5 Flash (High)	Web search only; prepends search_web instruction automatically
code	Gemini 3.1 Pro (High)	Read files; returns generated code as text, no writes
analysis	Gemini 3.1 Pro (High)	Read files; handles large codebases
review	Gemini 3.1 Pro (High)	Read files; adversarial framing
implement	Gemini 3.1 Pro (High)	Read and write files; no shell execution

Omit --type to default to code. Override the model with --model "Gemini 3.5 Flash (Low)". Run agy models for current names — the table above may lag agy releases.

Requirements

• agy installed and authenticated via OAuth
• python3 3.6 or later (standard on all modern systems)
• timeout or gtimeout — Linux ships timeout; macOS needs brew install coreutils

Installation

1. Install and authenticate agy.

Follow the agy project's installation instructions. After installing, run agy once interactively to complete the OAuth flow. Credentials land in ~/.gemini/antigravity-cli/.

2. Install dependencies.

# macOS — timeout (coreutils); python3 ships with macOS
brew install coreutils

# Debian/Ubuntu — timeout is in coreutils, already present on most systems
# python3 is standard; install if missing:
sudo apt install python3

3. Install this plugin.

From GitHub:

claude plugin marketplace add https://github.com/davdittrich/delegate-agy
claude plugin install agy-delegate

Or from a local clone:

git clone https://github.com/davdittrich/delegate-agy
claude plugin install ./delegate-agy

4. Create the symlinks.

Run once after install — creates ~/.local/bin/agy-bridge and ~/.local/bin/gemini (the drop-in shim):

/agy-setup

5. Verify.

agy-bridge --types

Expected output:

type         model                          timeout
search       Gemini 3.5 Flash (High)        300s
code         Gemini 3.1 Pro (High)          600s
analysis     Gemini 3.1 Pro (High)          600s
review       Gemini 3.1 Pro (High)          600s
implement    Gemini 3.1 Pro (High)          600s

Usage

The skill triggers automatically inside Claude sessions. For direct use:

# Web search with citations
echo "Claude API pricing June 2026" | agy-bridge --type search

# Code review — agy reads the file itself
echo "Review scripts/deploy.sh for correctness" | agy-bridge --type review

# Inline prompt without stdin
agy-bridge --type search -- "latest numpy release"

# JSON output envelope
echo "query" | agy-bridge --type search --json

JSON output:

{
  "success": true,
  "model_used": "Gemini 3.5 Flash (High)",
  "type": "search",
  "duration_seconds": 9,
  "response": "..."
}

Troubleshooting

Error	Fix
agy-bridge: command not found	Run /agy-setup to create the symlink
agy: command not found	Add ~/.local/bin to $PATH: bash/zsh: export PATH="$HOME/.local/bin:$PATH" · fish: fish_add_path ~/.local/bin
Response missing source URLs	Use --type search
Model name rejected	Run agy models; exact string required
Exit code 124	Timeout — simplify the query or pass --timeout 600
ERROR: timeout/gtimeout not found in PATH	brew install coreutils (macOS)

Security

Don't pipe credentials, API keys, or PII through the bridge. Prompts use stdin to stay out of process listings. Per-type tool restrictions prevent agy from running shell commands in any mode. Model names are validated at startup against a list fetched from agy and cached for 60 minutes at ~/.cache/agy-bridge-models.

Drop-in gemini CLI replacement

scripts/gemini_shim.sh is a transparent gemini CLI shim backed by agy. Install it as gemini on your PATH so that frameworks that call gemini automatically use agy instead — no configuration changes in those frameworks required.

Frameworks supported

Framework	How it calls gemini	Shim handles
Claude Octopus	gemini -m <model> -o text --approval-mode yolo via stdin	✓ flag mapping, model mapping, plain text output
Metaswarm	gemini --yolo --output-format json --model pro --include-directories <dir> <prompt>	✓ flag mapping, model mapping, JSON envelope with usageMetadata

Flag mapping

gemini flag	agy equivalent
-m / --model <name>	--model <name> (with name mapping)
-o text / --output-format text	(default — no flag needed)
--output-format json	wraps output in {"response":…,"usageMetadata":{…}} envelope; token counts are null (agy does not expose usage)
--approval-mode yolo	--dangerously-skip-permissions
--yolo	--dangerously-skip-permissions
--sandbox	(omitted — read-only enforced via GEMINI.md tool restrictions)
--include-directories <dir>	--add-dir <dir>
--version	agy --version

Model name mapping

gemini name	agy model
pro (Metaswarm default)	Gemini 3.1 Pro (High)
gemini-pro	Gemini 3.1 Pro (High)
gemini-2.5-pro / gemini-3.1-pro	Gemini 3.1 Pro (High)
gemini-2.5-pro-preview-06-05	Gemini 3.1 Pro (High)
flash	Gemini 3.5 Flash (High)
gemini-flash	Gemini 3.5 Flash (High)
gemini-2.5-flash / gemini-3.5-flash	Gemini 3.5 Flash (High)
gemini-2.5-flash-preview-04-17	Gemini 3.5 Flash (High)
any other string	pass through unchanged

Mappings are in config/model-map.json — add aliases there without touching scripts.

Manual installation

# Symlink shim as 'gemini' in a directory that precedes the real gemini on PATH
mkdir -p ~/.local/bin
ln -sf /path/to/delegate-agy/scripts/gemini_shim.sh ~/.local/bin/gemini
# Verify:
gemini --version   # should print agy version

Or use /agy-setup, which sets up both agy-bridge and gemini in one step.

Octopus configuration

No changes needed. Octopus checks command -v gemini; the shim satisfies that check. To override the model:

export OCTOPUS_GEMINI_MODEL="gemini-2.5-flash"

Metaswarm configuration

No changes needed. Metaswarm's gemini adapter checks command -v gemini; the shim satisfies the health check. agy --version output is returned as the version string.

File layout

scripts/agy_bridge.sh          — typed bridge (symlinked to ~/.local/bin/agy-bridge)
scripts/gemini_shim.sh         — drop-in gemini CLI shim (symlinked to ~/.local/bin/gemini)
skills/agy-delegate/SKILL.md   — skill definition
config/provider.md             — provider details, auth, timeout guidance
config/model-map.json          — gemini alias → agy model name mapping table
config/policies/               — GEMINI.md tool restriction policies (one file per mode)
  search.md                    — web search only
  code.md                      — read + grep, no writes
  review-analysis.md           — read + grep, no writes
  implement.md                 — read + write, no shell
  shim-yolo.md                 — gemini shim --yolo (read + write, no shell)
  shim-sandbox.md              — gemini shim --sandbox (read only)
  shim-default.md              — gemini shim default (read only)