AG Bridge (Antigravity Bridge)

February 17, 2026 · View on GitHub

A lightweight Mobile Interface for the Antigravity Agent. Chat with your AI agent from your couch, verify tasks, and "poke" it to wake up—all from your phone.

Features

  • 📱 Mobile Chat UI: Full chat interface with history and [Mobile] context prefix.
  • 🩸 The Poke & Batching: Remotely wakes up the Agent. Queued messages are batched for better context.
  • 💓 Heartbeat: Real-time connection status indicator (Green/Red).
  • 🔒 LAN Only: Your data stays on your network. No cloud databases.
  • 🔌 MCP Integration: Agent can read messages and report status directly.

Architecture

Phone <-> Bridge Server <-> Antigravity (Agent) (See Architecture for details).

Requirements

  • Node.js: v18+
  • Antigravity: Launched with --remote-debugging-port=9000 via terminal.
  • Network: Same Wi-Fi OR Tailscale for remote access.

Quick Start

1. Start AG (Critical)

You must start AG from a terminal to enable the Poke:

antigravity.exe . --remote-debugging-port=9000

*(If the Agent doesn't "wake up", this is usually why.)*

### 2. Install & Start Bridge
```bash
npm install
npm start

You will see a Pairing Code and IP Address in the console.

3. Open on Phone

  1. Go to http://<YOUR_IP>:8787 on your phone.
  2. Enter the Pairing Code.
  3. Chat away!

Remote Access (Optional) ☁️

AG Bridge is designed as a LAN-first tool. It binds to 0.0.0.0 to be accessible on your local Wi-Fi.

For remote access (outside your home):

  • Recommended: Use Tailscale (or wireguard) to create a secure mesh network.
  • Warning: Do NOT forward port 8787 directly to the open internet. The token auth is robust, but the server is not hardened for public exposure.
  • Note: Using a VPN/Tailscale does NOT bypass authentication; you will still need to pair your device.

Testing & CI 🧪

To run the test suite locally:

npm test

(Runs unit tests and smoke tests via Vitest)

To scan for repo hygiene issues:

npm run check:bidi

(Scans for hidden Unicode characters)

CI: GitHub Actions automatically runs these tests on every Pull Request.

Documentation

License

MIT. Built for the Antigravity community.

Contributing

See CONTRIBUTING.md.