KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

ag_bridge

★ 118 Open GitHub ↗

Control your Antigravity instance from your Mobile

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AG Bridge (Antigravity Bridge)

**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](docs/architecture.md) for details).

## Requirements
- **Node.js**: v18+
- **Antigravity**: Launched with `--remote-debugging-port=9000` via terminal.
- **Network**: Same Wi-Fi **OR** [Tailscale](docs/remote_with_tailscale.md) for remote access.

## Quick Start

### 1. Start AG (Critical)
You **must** start AG from a terminal to enable the Poke:
```bash
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.
3. Enter the Pairing Code.
4. 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:
```bash
npm test
```
(Runs unit tests and smoke tests via Vitest)

To scan for repo hygiene issues:
```bash
npm run check:bidi
```
(Scans for hidden Unicode characters)

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

## Documentation
- [Architecture](docs/architecture.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Security](docs/security.md)

## License
MIT. Built for the Antigravity community.

## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).

ag_bridge

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README