Codex Agy Bridge
by varadfromeastcommunityv0.1.5
2
An MCP stdio server that wraps the Antigravity CLI (`agy`) to manage durable, resumable runs through MCP. It lets a client start, wait on, observe, input to, cancel, and collect results from parallel `agy` sessions, including interactive foreground runs via `tmux`.
From the registry: Run parallel, resumable, human-operable Antigravity CLI sessions from any MCP agent harness
Install & configure
Prerequisites
- requiredInstall Antigravity CLI (agy)Install the official Antigravity CLI and authenticate it locally before using this MCP server.
- requiredInstall uvxInstall uv/uvx so the MCP server can be launched from PyPI.
- requiredInstall tmuxtmux is required on macOS for persistent terminal sessions used by the bridge.
$ brew install tmux - requiredUse a local stdio MCP-capable clientYou need an MCP client or harness that can launch local stdio servers, such as Codex CLI, Claude Desktop, or another compatible client.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `codex-agy-bridge` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Antigravity CLI (agy)** — Install the official Antigravity CLI and authenticate it locally before using this MCP server.
- **Install uvx** — Install uv/uvx so the MCP server can be launched from PyPI.
- **Install tmux** — tmux is required on macOS for persistent terminal sessions used by the bridge. Run: `brew install tmux`
- **Use a local stdio MCP-capable client** — You need an MCP client or harness that can launch local stdio servers, such as Codex CLI, Claude Desktop, or another compatible client.
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["codex-agy-bridge@latest"]
- required environment variables:
- `AGY_CMD`: Absolute path to the authenticated Antigravity CLI executable used by the bridge. (example: `<path-to-agy>`)
- optional environment variables:
- `AGY_BRIDGE_STATE_DIR`: Directory where durable run and goal state is stored. (example: `<path-to-state-dir>`)
- `AGY_BRIDGE_AGY_ROOT`: Root directory containing Antigravity conversations and trajectory files. (example: `<path-to-antigravity-root>`)
- `AGY_BRIDGE_MAX_PARALLEL`: Global concurrent-run limit. (example: `<max-parallel-runs>`)
- `AGY_BRIDGE_COMPLETION_STABILITY_SECONDS`: Time in seconds that a final marker must remain stable before completion is accepted. (example: `<seconds>`)
Note: Preferred install path is PyPI via uvx. The README says Claude Desktop or a custom MCP client should use the same stdio command shape: `uvx codex-agy-bridge@latest` with `AGY_CMD` set. The server targets Python 3.11+, uses stdio transport, and depends on a locally installed/authenticated `agy` binary.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Preferred install path is PyPI via uvx. The README says Claude Desktop or a custom MCP client should use the same stdio command shape: `uvx codex-agy-bridge@latest` with `AGY_CMD` set. The server targets Python 3.11+, uses stdio transport, and depends on a locally installed/authenticated `agy` binary.
Tools (8)
agy_run_start
Start, continue, or open an interactive foreground run
agy_run_wait
Block until selected runs emit sparse wake events
agy_run_observe
Read full, status, transcript, or raw terminal views
agy_run_input
Send input with optional event/transcript preconditions
agy_run_cancel
Cancel one active run
agy_run_result
Read final result metadata or bounded result chunks
agy_goal
Create goals, start targets, and read aggregate status
agy_admin
Read diagnostics, models, plugins, validation, and changelog
Environment variables
AGY_CMDrequiredPath to the exact Antigravity executable used by the bridgePrerequisites
- • Python 3.11+
Packages
codex-agy-bridge
pypiv0.1.5transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Jun 18, 2026
- Last commit
- Jun 17, 2026
- Registry name
- io.github.varadfromeast/codex-agy-bridge
Categories
Related Servers
Netdata
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
79.7k
Codebase Memory Mcp
Persistent codebase knowledge graph. Survives session restarts and context compaction.
31.9k
Oh My Posh Validator
Validate oh-my-posh configurations and segment snippets against the official schema.
23.0k