Async Parallel Antigravity for Codex & Claude Code MCP server

codex-agy-bridge

Run Antigravity from an agent harness as durable, parallel, human-operable agy sessions over MCP.

<!-- mcp-name: io.github.varadfromeast/codex-agy-bridge -->

codex-agy-bridge wraps the official Antigravity CLI with a resumable MCP control plane. Agent harnesses like Codex, Claude Desktop, or your own GPT/Claude-powered MCP client can start agy runs, wait on sparse events, attach a real terminal, send guarded input, cancel safely, continue exact conversations, and collect final results later by run_id.

Quick Install

Prerequisites:

• Codex CLI for the command below, or another local stdio MCP-capable harness
• The official Antigravity CLI (agy), already authenticated locally
• uv / uvx
• tmux and a supported terminal launcher:

# macOS
brew install tmux

# Debian/Ubuntu Linux (x-terminal-emulator is also supported)
sudo apt install tmux gnome-terminal

Check the required commands:

codex --version
agy --version
agy models
uvx --version
tmux -V

Day 0 Authentication

agy --version only proves the binary exists. Before adding the MCP server, run agy models; if Antigravity asks you to sign in or reports that you are not logged in, start a visible session and complete the browser/login flow:

agy --prompt-interactive "Authenticate Antigravity and then exit."
agy models

After agy models succeeds, install or restart the MCP server. If a bridge run still hits auth, agyrunstart returns status="authrequired" and opens a visible agy authentication session by default. Complete sign-in there, then start a fresh run. You can also use agyrunobserve(view="terminal") or agyadmin(action="doctor") to inspect the auth-required status.

Install from PyPI with the Codex CLI:

codex mcp add codex-agy-bridge \
  --env AGY_CMD="$(command -v agy)" \
  -- "$(command -v uvx)" codex-agy-bridge@latest

Restart the harness, then verify in Codex if you used the command above:

codex mcp get codex-agy-bridge
codex mcp list

Remove it with:

codex mcp remove codex-agy-bridge

For Claude Desktop or a custom MCP client, use the same stdio command shape: uvx codex-agy-bridge@latest with AGY_CMD set to the authenticated agy executable.

What Makes It Different

each with its own durable state, logs, transcript projection, and result.

• Parallel Antigravity sessions: launch multiple independent agy runs,

sessions, so Terminal.app can attach without killing the agent.

• Human-operable terminals: foreground runs live in persistent tmux

and the run can still be observed later by run_id.

• Resumable MCP control: MCP calls can time out, the harness can restart,

parallelism, and inspect the whole batch as one coordinated effort.

• Goal orchestration: create a goal, start named targets with bounded

progress, and terminal events without transcript-polling spam.

• Sparse wake events: agyrunwait short-polls lifecycle, attention,

transcript cursors changed after the caller observed the run.

• Guarded input: agyruninput can reject stale writes when event or

evidence are exposed without private model reasoning.

• Trajectory-aware observability: bounded transcript summaries and terminal

groups are cancelled safely, and completed result artifacts are preserved.

• Operational hygiene: duplicate active starts are deduplicated, process

Install Details

If You Are An Agent Reading This

Help the user install it; do not silently mutate their machine.

1. Verify prerequisites first:

command -v codex
command -v agy
command -v uvx
command -v tmux
agy --version
agy models

Shortened. The full README is on GitHub.