Skip to main content
Glama

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 agy command-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, on PATH, or at $AGY_BIN. Tested with AGY 1.5.1 and 1.5.2.

  • Claude Code, with the claude command on PATH (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 install

Restart Claude Code, then check the setup:

uv run agy-bridge doctor

install copies three AGY agents with their skills, plus a Claude skill, and registers the server:

What

Where

AGY agent code-reviewer: an outside senior reviewer for code changes

~/.gemini/config/agents/code-reviewer.md

Its AGY skill, code-review

~/.gemini/config/skills/code-review/

AGY agent design-reviewer: an outside architect for designs, ADRs and plans

~/.gemini/config/agents/design-reviewer.md

Its AGY skill, architecture-review, with ten review lenses

~/.gemini/config/skills/architecture-review/

AGY agent thinking-partner: brainstorming and planning before a task, and review of any kind of work

~/.gemini/config/agents/thinking-partner.md

Its AGY skill, thinking-techniques, with brainstorming and review techniques

~/.gemini/config/skills/thinking-techniques/

The Claude skill that teaches Claude the review loop

~/.claude/skills/agy/SKILL.md

The MCP server, named agy

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

License

MIT © Daniel Gwerzman

Available Tools

8 tools
agy_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

    A3.7/5.0

    Scored across 8 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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 npm
      MIT