Skip to main content
Glama

ant-bridge

ACP model provider and loopback MCP/skill bridge for Pi (@earendil-works/pi-coding-agent >= 1.5).

ant-bridge connects Pi to the agy CLI over stdio JSON-RPC (agy acp), registers models under the antigravity provider, and exposes Pi's extension, MCP, codemode, subagent, and skill surfaces over a per-session 127.0.0.1 Streamable HTTP MCP server (pi-bridge and per-server pi-bridge-<server> routes). It does not register extra Pi tools, wrap core file/shell tools, or write to shared global MCP config files.

Prerequisites

  1. Pi >= 1.5 (pi --version).

  2. agy >= 1.5.3 on PATH and signed in (agy --version, then agy once to sign in if needed).

Related MCP server: Xiaozhi AI MCP Bridge

Install and update

Install directly from GitHub via Pi's package manager:

pi install git:github.com/reedjosh/ant-bridge

Update installed extensions to the latest commit (or update only ant-bridge):

pi update --extensions
# or update only ant-bridge:
pi update git:github.com/reedjosh/ant-bridge

If you previously installed @estebanforge/pi-antigravity-bridge, remove it first so two extensions do not register the same antigravity provider:

pi remove npm:@estebanforge/pi-antigravity-bridge

Usage

Switch models interactively inside Pi:

/model antigravity/gemini-4-carbon

Or set a default in ~/.pi/agent/settings.json:

{
  "defaultProvider": "antigravity",
  "defaultModel": "gemini-4-carbon"
}

How tool bridging works

  • Workspace tools stay native: agy acp executes file reads/edits, search, and shell commands directly in its own runtime. Core Pi file/shell builtins (read, write, edit, bash, grep, find, ls) are excluded from the MCP bridge so tools are never duplicated.

  • Pi 1.5 extension and MCP tools bridge automatically: Active Pi extension tools (including builtin:codemode, builtin:mcp, builtin:tool-search, pi-subagents, and PR tracking tools) are served on pi-bridge, while direct Pi MCP tools (mcp__<server>__<tool>) bridge onto per-server pi-bridge-<server> routes over loopback 127.0.0.1 HTTP authenticated with a per-session random header token (x-bridge-token).

  • Live catalog sync: Whenever the active bridged tool catalog changes between turns (for example after tool_search loads deferred tools, /mcp updates server exposure or connection state, /agy bridge or /agy tools changes bridged scope, or /reload runs), ant-bridge automatically recycles agy acp and reloads the bound session (session/load) so agy sees the updated MCP routes and schemas without losing conversation history.

  • Skills: Pi Agent Skills are exposed dynamically via activate_skill on pi-bridge, sourced live from pi.getCommands() (reflecting package, settings, project-trusted skills, and /reload updates) with a filesystem scanSkills fallback.

  • Usage footer: Streaming turns display live ACP token counts in the status bar (ACP <in> in (+<cached> cached) / <out> out when native usage is reported, or ACP ~ <in> in / <out> out for client-side estimates, hidden while all counts are zero).

  • Long-running tool escalation: Calls that exceed their foreground window (120s for subagent and codemode, 20s for other bridged tools) return a STILL RUNNING handle that resolves via bridge_poll_result without hitting transport timeouts.

  • Session persistence: Each agy acp subprocess runs with a staged HOME under <agentDir>/antigravity-bridge/acp-homes/ whose antigravity-cli state directory symlinks back to ~/.gemini/antigravity-cli, isolating MCP configuration per session while preserving conversation state across restarts.

MCP server exposure

Pi 1.5 controls how MCP servers in ~/.pi/agent/mcp.json or .pi/mcp.json (or interactively via /mcp) reach the model:

  • "exposure": "direct" (recommended for daily-driver servers): Pi declares each tool directly, and ant-bridge bridges the server onto its own pi-bridge-<server> MCP route (mcp_pi-bridge-<server>_<tool> when eager, or via call_mcp_tool when agy marks a large catalog Lazy:). Calls execute directly and render as clean <server>/<tool> rows in Pi. You can also promote specific tools on a larger server with "toolExposure".

  • "exposure": "codemode" (Pi default): Tools are not declared as individual MCP tools; agy reaches them via codemode (searchTools, describeNamespace, tools.mcp__<server>__<tool>) to batch or filter multi-step calls in one script.

  • "exposure": "deferred": Tools stay undeclared until tool_search loads matching tools into Pi's active tool catalog; on the next turn ant-bridge recycles agy acp, reloads the bound session, and exposes the loaded tools on pi-bridge-<server>.

{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp",
      "exposure": "direct"
    }
  }
}

Commands

Run /agy inside Pi to open the settings picker (or display status in non-TUI modes), or pass a subcommand:

  • /agy - interactive configuration picker (bridgeTools, timeouts, permission mode, usage estimate, digest).

  • /agy doctor - check agy binary version, active bound conversation, driver stats (spawns, turns, recycles), and loopback MCP server status.

  • /agy bridge all|mcp|none - update bridged tool scope live and start the loopback pi-bridge MCP server on demand when switching from none to all or mcp (no /reload needed).

  • /agy tools [hide|show <name>|reset] - inspect or toggle which Pi tools are exposed over pi-bridge, with tab completion over pi.getAllTools().

  • /agy tasks [tail <id>] - browse background task logs in the bound conversation directory (Enter tails the last 40 lines, r rescans), with tab completion over task IDs on /agy tasks tail <id>.

  • /agy artifacts [open <n|name>] - browse or open artifacts in the bound conversation directory, with tab completion over artifact filenames on /agy artifacts open <name>.

  • /agy quota - display model quota status from agy usage.

  • /agy clear [all] - clear the conversation binding for the current Pi session only (leaving other open Pi sessions untouched), or pass all to clear persisted bindings across every Pi session.

Configuration and session bindings are stored under ~/.pi/agent/antigravity-bridge/ (or $PI_CODING_AGENT_DIR/antigravity-bridge/).

Development

npm install
npm test

Peer packages (@earendil-works/* and typebox) are resolved from the host Pi installation and intentionally omitted from node_modules.

License

MIT. Forked from @estebanforge/pi-antigravity-bridge 1.10.4 and focused down to an ACP-only provider and Pi 1.5 loopback MCP bridge.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to securely access local machine capabilities such as file operations, shell commands, Skills, and Pi Tools through a controlled MCP interface with token authorization and multiple tunnel options.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI assistant to invoke local file operations, multi-engine web search, weather, system commands, developer utilities, and code execution over MCP, and includes a web dashboard for managing endpoints, testing tools, and viewing live logs.
      43 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets MCP clients create, resume, message, and stop Pi coding-agent sessions running on another machine, with conversations that survive client disconnects and server restarts. Sessions can be kept loopback-only or published privately to trusted callers over Tailscale HTTPS.
      1
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables any MCP client to browse, triage, search, read, and drive pi coding agent sessions through Pi Web's HTTP API via 25 tools. Supports listing and filtering sessions, reading transcripts, flagging conversations awaiting input, sending messages and waiting for replies, inspecting project diffs, and forking, renaming, or deleting sessions over either stdio or Streamable HTTP.
      25
      MIT