ag_bridge - GitLite

KO | EN

gitlite — search

#javascript #python #ai #go #machine-learning #nodejs #macos #java #windows #awesome #cli #awesome-list #mcp #openai

ag_bridge

(★ 120)

Control your Antigravity instance from your Mobile

File Explorer

Download Latest Version (.zip)

- ag_memory_seed.md
- - bug_report.md
  - feature_request.md
- - ci.yml
- pull_request_template.md
- settings.json
- tasks.json
- state.template.json
- architecture.md
- BRANCHING.md
- CORE_CONTRACT.md
- RELEASING.md
- remote_with_tailscale.md
- security.md
- troubleshooting.md
- index.html
- manifest.json
- sw.js
- check-bidi.mjs
- poke.mjs
- precommit.mjs
- approval.test.js
- no-secrets.test.js
- smoke.test.js
- ws_replay.test.js
.gitignore
CHANGELOG.md
CONTRIBUTING.md
mcp-server.mjs
mcp_debug.log
package-lock.json
package.json
policy.json
README.md
request-approval.mjs
server.mjs
test_mcp_init.json

# Installation Guide

1. Get the code

git clone https://github.com/Mario4272/ag_bridge

Downloads the entire project code from GitHub to your computer.

cd ag_bridge

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

// 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).