agy-bridge
Enables Claude Code to start and converse with a Google Antigravity (AGY) reviewer agent for multi-turn code and design reviews, including sending changes, receiving structured findings and verdicts, replying with fixes or counterarguments, and resuming review sessions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@agy-bridge Review my uncommitted changes with AGY and suggest fixes."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
agy-bridge
Get a second opinion on Claude Code's work from a Google Antigravity (AGY) agent, and let the two of them talk it through: to review what Claude made, or to think a task through before Claude starts it.
agy-bridge is an MCP server. It gives Claude Code tools to start an AGY agent, send it work or a problem, read its answer, reply with fixes, counter-arguments or answers, and keep the conversation going over several turns, even across Claude Code sessions.
Why a second agent, and how the review should run: the review method behind agy-bridge.
Not affiliated with Google or Anthropic. agy-bridge is an independent open-source project. Antigravity and Gemini are Google products; Claude and Claude Code are Anthropic products. It drives the
agycommand-line tool you already have, using your own Antigravity login.
How it looks
You ask Claude Code:
Implement the retry logic from the plan, then run AGY with the code-review skill.
Claude writes the code and runs the tests. Then it starts an AGY code-reviewer, which
reads the project, runs the tests itself and returns a structured review:
{
"verdict": "changes_requested",
"summary": "Retries work, but the backoff ignores Retry-After and one path never gives up.",
"findings": [
{"severity": "high", "category": "correctness", "location": "client.py:88",
"issue": "...", "recommendation": "..."}
],
"questions_for_claude": ["Should a 429 count towards max_attempts?"]
}Claude fixes what it agrees with, argues with what it doesn't, answers the questions and sends the new diff back. AGY re-checks. When they agree, or after a few rounds, Claude reports the outcome to you, including any point they still disagree on.
It isn't only for code. Before starting something new, you might ask:
Before you draft my conference talk on agy-bridge, brainstorm it with AGY's thinking partner.
AGY's thinking-partner picks a technique (here, writing the announcement first, and a
pre-mortem) and checks where Claude's claims come from before building on them:
{
"verdict": "needs_discussion",
"reframed_problem": "Show developers who already use Claude Code why a second, different model makes their reviews better.",
"assumptions": [
{"statement": "The audience knows what MCP is", "source": "inferred",
"risk": "If they don't, the first ten minutes are lost on setup."}
],
"options": [
{"idea": "Live demo of one bug caught by AGY that Claude missed",
"gains": "Memorable, concrete", "costs": "Demo risk; needs a reliable example"}
],
"questions_for_claude": ["(user) Who is the audience: beginners or MCP users?"]
}Claude passes your questions to you, discusses the options with AGY, and brings you a short list to choose from before writing anything.
Related MCP server: mcp-agent-review
Requirements
AGY CLI, installed and signed in. agy-bridge finds it at
~/.gemini/bin/agy, onPATH, or at$AGY_BIN. Tested with AGY 1.5.1 and 1.5.2.Claude Code, with the
claudecommand onPATH(used to register the server).Python 3.11+ and uv.
macOS or Linux. Tested on macOS; Linux runs in CI. Windows is not supported.
Quick start
git clone https://github.com/kulaone/agy-bridge.git
cd agy-bridge
uv sync
uv run agy-bridge installRestart Claude Code, then check the setup:
uv run agy-bridge doctorinstall copies three AGY agents with their skills, plus a Claude skill, and registers
the server:
What | Where |
AGY agent |
|
Its AGY skill, |
|
AGY agent |
|
Its AGY skill, |
|
AGY agent |
|
Its AGY skill, |
|
The Claude skill that teaches Claude the review loop |
|
The MCP server, named | Claude Code's user config |
It never overwrites a file you have changed, and agy-bridge uninstall removes only
what it added. See the install guide for per-project installs and
other options.
Use it
Ask Claude Code in your own words:
"Review my uncommitted changes with AGY."
"Run AGY with the code-review skill on this branch against main, using Argon high."
"Ask the AGY design reviewer about docs/design/sync.md before we build it."
"Before we start, brainstorm with AGY how to onboard new customers. Go wild."
"Have AGY's thinking partner review the launch email draft."
"What is AGY doing right now?"
"Resume yesterday's AGY review of this project."
The user guide covers choosing models, long reviews, reading the results and resuming sessions.
What AGY may do
AGY is a full reviewer. It may read the whole project, run tests, linters and builds, and experiment in its own scratch folder. Its instructions forbid changing the project, and its file-writing tools only work in that scratch folder. Shell commands can't be limited that way, so agy-bridge also:
detects any change to the project during each turn and reports it to Claude, which tells you;
backs up your uncommitted work before each turn, so it can be restored;
never runs AGY with
--dangerously-skip-permissions.
Read SECURITY.md before using it on code you can't afford to have touched.
Use at your own risk. agy-bridge is provided as is, with no warranty and no support commitment. You are responsible for what it and AGY do on your machine.
Documentation
The review method: why agy-bridge exists, and the four-stage review it runs
Install guide: install options, per-project installs, uninstalling
User guide: reviews, models, results, sessions, the tools
Configuration: environment variables, files and folders
Writing your own agents: add a docs or security reviewer
Architecture: how it works and why
Contributing and the changelog
License
MIT © Daniel Gwerzman
Available Tools
8 toolsagy_endA
Stop a session's AGY process. The session stays resumable unless forget=True, which also deletes it from the registry and removes its scratch, backup and log files.
Inputs: session_id (required), forget. Returns: object
agy_list_agentsA
List AGY agents available to agy_start and the model slugs AGY offers.
Model slugs may carry an effort level (e.g. "-high"); pass either a full slug, or a base
slug plus `effort`. Never assume a fixed list: always read it here.
Inputs: refresh_models. Returns: object
agy_resumeA
Re-open a stored AGY session in a fresh process, by session_id or conversation_id. For a conversation the bridge has never seen, also pass agent and cwd. agy_say also resumes automatically, so this is only needed to warm a session up front.
Inputs: cwd, agent, session_id, conversation_id. Returns: object
agy_sayA
Send the next message in an AGY session: fixes made (with the new diff), answers to AGY's questions, or arguments against a finding. Resumes the conversation automatically if its process has ended (e.g. in a later Claude session). model/effort default to the session's previous choice, except that a new model starts with no effort unless one is given. Changing them restarts the process on the same conversation.
Inputs: message (required), session_id (required), model, effort, +1 more. Returns: object
agy_sessionsB
List stored AGY sessions, most recently used first. Filter by project with cwd.
Inputs: cwd, limit. Returns: result
agy_startA
Open a new AGY review session and send the first message.
agent: an AGY agent, e.g. code-reviewer; agy_list_agents lists those installed.
cwd: absolute path of the project to review (AGY runs there).
message: what to review and why: diff or file/doc paths, intent, how to run tests.
model / effort: optional; omit to use AGY's default. See agy_list_agents.
schema: optional JSON schema for the answer; defaults to the review schema
(verdict, summary, findings, questions_for_claude).
wait_seconds: how long to wait for the answer before returning status RUNNING
(the turn keeps going; collect it with agy_wait).
Returns the session_id, the review, and notes (denied actions, files AGY changed).
Inputs: cwd (required), agent (required), message (required), model, +3 more. Returns: object
agy_statusB
What an AGY session is doing right now: idle or working, current turn, elapsed time, and the last tool steps AGY took. Use it when the user asks for progress.
Inputs: session_id (required). Returns: object
agy_waitA
Keep waiting for a turn that agy_start/agy_say returned as RUNNING, and return its result when done. Returns the last result again if no turn is running.
Inputs: session_id (required), wait_seconds. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool maps to a distinct lifecycle step (start/say/wait/status/resume/sessions/end), and descriptions clearly delimit agy_status (quick peek) from agy_wait (blocking) and agy_resume (warm-up only). The one real overlap is agy_resume vs agy_say's automatic resume, which the description explicitly acknowledges.
All tools share the agy_ prefix and snake_case, with mostly verb-led names (agy_start, agy_say, agy_list_agents). agy_status and agy_sessions are noun-only, a minor deviation but still predictable and readable.
Eight tools is well-scoped for a session-bridge server, each corresponding to a genuine lifecycle operation. Nothing feels padded, and no obvious capability is crammed into a generic catch-all tool.
Full lifecycle coverage: agent discovery, start, converse, wait, resume, list, status, and end with optional forget. The main gap is no way to retrieve a past turn's transcript or full history from an ended session, though status and prior results partially compensate.
Maintenance
Related MCP Connectors
FixMyPrompt is a remote MCP server for coding agents. It saves the steps your agent worked out as project memories and fetches them in later sessions, scores and rewrites prompts, and checks CLAUDE.md and AGENTS.md files. Works with Claude Code, Codex and Cursor. Free plan available.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Meta Ads and Google Ads MCP server: 250+ tools for Claude, ChatGPT, Cursor and Codex.
The official Upwork MCP server, letting AI agents connect to Upwork and act on your behalf.
Related MCP Servers
- AlicenseAqualityFmaintenanceA server that allows LLMs to run Claude Code with all permissions bypassed automatically, enabling code execution and file editing without permission interruptions.1307 npm1,315MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides agentic code review powered by OpenAI-compatible models, designed for use with Claude Code.1MIT
- FlicenseBqualityDmaintenanceMCP server that gives AI coding agents (Claude Code, Cursor, Cline, etc.) access to multiple AI models through Antigravity CLI and OpenAI Codex CLI, enabling mid-conversation model consultation and code review.8-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that lets Claude Code call the Google Antigravity CLI (agy) headlessly for a second opinion from a different model family, or to have agy read project files on Claude's behalf so large files never enter Claude's context window.35 npmMIT