Async Parallel Antigravity — MCP server for Codex and Claude Code
A wrapper around the official Antigravity CLI that turns it into resumable MCP-controlled sessions. You can run several agy jobs at once, attach a terminal, and pick up results later.
claude mcp add --env AGY_CMD=<AGY_CMD> --transport stdio async-parallel-antigravity-for-codex-claude-code -- uvx codex-agy-bridgeWhat Async Parallel Antigravity for Codex & Claude Code does
The server hands each agy run to a detached supervisor, so the MCP endpoint stays quick while the CLI does the long work. State and events live locally. If an MCP call times out or the harness restarts, you can still pull the run by run_id and read what came out of it.
Runs surface through eight tools: agy_run_start, agy_run_wait, agy_run_observe, agy_run_input, agy_run_cancel, agy_run_result, agy_goal, agy_admin. The input tool carries preconditions tied to event and transcript cursors — a write gets rejected if the run moved on after the caller last looked at it. Two agents writing into the same session won't silently clobber each other.
Before adding the server, agy models has to succeed locally; that proves the CLI is authenticated. If auth is missing, agy_run_start returns status="auth_required" and opens a visible session for the login flow. You also need uvx and tmux — brew install tmux on macOS, sudo apt install tmux gnome-terminal on Debian or Ubuntu. The bridge itself ships from PyPI as codex-agy-bridge.
What it helps with
- start several Antigravity runs in parallel without mixing their state
- attach a terminal to a live run without killing the agent process
- read a run result after an MCP timeout or harness restart
- block stale writes when the transcript has already moved forward
- batch multiple targets under one goal and inspect aggregate status
Example prompts for the agent
- Start an Antigravity run with the prompt "Write tests for this module" and wait for the first event.
- Check the run status for the
run_idfrom the previous call, status only, no full transcript. - Open a terminal view of the current run with
agy_run_observeand view=terminal, I need to answer an auth prompt by hand.
How to install Async Parallel Antigravity for Codex & Claude Code
Platform CLI
claude mcp add --env AGY_CMD=<AGY_CMD> --transport stdio async-parallel-antigravity-for-codex-claude-code -- uvx codex-agy-bridgeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from codex-agy-bridge <command>
Platform CLI
codex mcp add async-parallel-antigravity-for-codex-claude-code --env AGY_CMD=<AGY_CMD> -- uvx codex-agy-bridgeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from codex-agy-bridge <command>
Config file
{
"mcpServers": {
"async-parallel-antigravity-for-codex-claude-code": {
"command": "uvx",
"args": [
"codex-agy-bridge"
],
"env": {
"AGY_CMD": "<AGY_CMD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from codex-agy-bridge <command>
Config file
{
"servers": {
"async-parallel-antigravity-for-codex-claude-code": {
"type": "stdio",
"command": "uvx",
"args": [
"codex-agy-bridge"
],
"env": {
"AGY_CMD": "<AGY_CMD>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from codex-agy-bridge <command>
Platform CLI
gemini mcp add -e AGY_CMD=<AGY_CMD> async-parallel-antigravity-for-codex-claude-code uvx codex-agy-bridgeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from codex-agy-bridge <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Async Parallel Antigravity for Codex & Claude Code
How do I install Async Parallel Antigravity in Codex?
Make sure agy models works first — that confirms the CLI is signed in. Then run codex mcp add async-parallel-antigravity-for-codex-claude-code --env AGY_CMD=<AGY_CMD> -- uvx codex-agy-bridge. Restart Codex so the new MCP tools load.
What does this MCP server do?
It wraps the official Antigravity CLI with an MCP control plane. The harness can start, wait on, cancel, and resume agy runs, while the processes themselves live in tmux sessions under detached supervisors, so a terminal can attach without killing the agent.
What do I need before installing it?
The official agy CLI, authenticated locally — agy models must return without an error. You also need uvx and tmux. If auth breaks mid-run, the server returns status="auth_required" and opens a visible session for sign-in.
