antigravity-gemini-bridge

Lightweight bridge between Gemini CLI and Antigravity Mobile via Supabase.

The CLI bridge that connects Antigravity Mobile (iOS) to your Gemini CLI on macOS, Linux, and Windows.

iOS app: Mobile IDE for Antigravity AI

Control your coding sessions from iPhone: send prompts, receive replies, and keep your workspace synced remotely.

This npm package runs as a local background bridge process.
Users usually start it from the connection page flow:

• https://luch.dev/antigravity?token=...&id=...

How It Works

The bridge connects three layers:

1. Antigravity Mobile (iOS) -> sends prompts via Supabase
2. antigravity-gemini-bridge (this package) -> receives prompts, runs gemini, sends replies
3. Antigravity Mobile (iOS) -> receives replies and keeps history synchronized

Pairing flow (one project at a time)

Only one bridge process and one active bridge_sessions row per device pair. To work in another folder: disconnect the project in the iOS app (Sessions), press Ctrl+C on the Mac bridge, cd to the new folder, run the bridge again, then Connect from the web page.

1. Install/open Mobile IDE for Antigravity AI on iPhone.
2. Open the mobile-generated link on your computer:
   • https://luch.dev/antigravity?token=...&id=...
3. Install Gemini CLI if needed:
   • npm i -g @google/gemini-cli
4. Sign in if needed:
   • gemini
5. In Terminal, cd to the project directory you want Gemini to use.
6. Start the bridge (stop any other bridge on this machine first):
   • npx antigravity-gemini-bridge@latest
7. Click Connect in the web page.

Apply sql/one_active_bridge_session_per_pair.sql on Supabase if the DB was created before this constraint (dedupes old rows, then adds the unique index).

Requirements

• Node.js >= 18
• Gemini CLI installed (@google/gemini-cli)
• Antigravity Mobile app (iOS)
• Supabase project configured for bridge tables:
  • messages
  • device_pairs
  • bridge_sessions
  • ide_presence

Local Development

cd gemini-bridge
npm install
cp .env.example .env
npm run dev -- --path /absolute/path/to/workspace

For production-style local run:

npm run build
node dist/index.js --path /absolute/path/to/workspace

License

Proprietary - see the Software License EULA.

© 2026 Ulad Luch. All rights reserved.