<div align="center">

📱 OmniAntigravity Remote Chat

Your AI coding session shouldn't end when you leave your desk.

<br/> <img src="assets/hero-banner.png" alt="Control your AI from the couch" width="700" /> <br/> <br/>

Mirror your Antigravity (Windsurf) AI chat on your phone in real-time. <br/> Send messages. Switch models. Manage windows. All from your mobile browser.

Get Started · Screenshots · How It Works · Docker · npm

🌐 Available in: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino

</div> <br/>

😤 The Problem

You're deep into an AI-assisted coding session. Claude is generating code, Gemini is reviewing your architecture. Then your phone rings, someone needs you in the kitchen, or you just want to move to the couch.

Your options today:

• ❌ Walk back to the desk every time the AI responds
• ❌ Try to read your monitor from across the room
• ❌ Copy-paste into a separate mobile app (losing context)
• ❌ Just... stop coding

There has to be a better way.

✅ The Solution

OmniAntigravity mirrors your entire Antigravity AI chat to your phone — in real-time, with full interaction. Read responses, send follow-up messages, switch AI models, even manage multiple editor windows. All from your mobile browser.

npx omni-antigravity-remote-chat

That's it. Open the URL on your phone. You're in. 🚀

New in 1.2.0

• Suggest Mode with queued approvals instead of immediate execution
• Session Stats and Quota panels inside the mobile workspace
• Assist tab for asking the supervisor what is happening right now
• Screenshot Timeline with persistent captures in data/screenshots/
• Five themes (dark, light, slate, pastel, rainbow)
• Vitest unit suite plus expanded smoke coverage

---

📸 See It in Action

<div align="center">

| Main Interface | Model Selection | Ready to Chat | | :--------------------------------------------------: | :----------------------------------------------------: | :---------------------------------------------------: | | <img src="assets/screenshot-main.png" width="280" /> | <img src="assets/screenshot-models.png" width="280" /> | <img src="assets/screenshot-input.png" width="280" /> | | Premium dark UI with live sync | Switch between Gemini, Claude, GPT | Send messages from your phone |

</div>

---

⚡ Get Started

One command — zero config:

npx omni-antigravity-remote-chat

Or install globally:

npm install -g omni-antigravity-remote-chat
omni-chat

Or run with Docker:

docker run -d --name omni-chat \
  --network host \
  -e APP_PASSWORD=your_password \
  diegosouzapw/omni-antigravity-remote-chat:latest

Prerequisite

Launch Antigravity in debug mode (one-time setup):

antigravity . --remote-debugging-port=7800

💡 Pro tip: Add alias agd='antigravity . --remote-debugging-port=7800' to your ~/.bashrc

---

🏆 Why Developers Choose This

| | Feature | Details | | --- | ---------------------- | ------------------------------------------------------------------------ | | 🛋️ | Code from anywhere | Read and reply to AI chats from your couch, bed, or kitchen | | 🪟 | Multi-window | Switch between multiple Antigravity instances from one phone | | 🔄 | Real-time sync | < 100ms latency via WebSocket — chat updates appear instantly | | 🤖 | Model switching | Toggle between Gemini, Claude, GPT from a mobile dropdown | | 🤖 | Remote Autonomy | Auto-detect and 1-tap accept/reject CLI instructions remotely | | 🧠 | Suggest Mode | Queue supervisor suggestions for manual review before desktop execution | | 📊 | Session Analytics | Track errors, approvals, uploads, quota warnings and screen activity | | 📈 | Quota Visibility | Read real model limits from the local Antigravity language server | | 💬 | Assist Workspace | Ask the supervisor for summaries, context and next actions | | 🖼️ | Timeline | Keep a persistent screenshot history with manual and automatic captures | | 📱 | Telegram Alerts | Get push notifications for Blocks, Task completion and Pending actions | | 📋 | Chat history | Browse and resume past conversations on mobile | | 🔒 | Secure by default | HTTPS, password auth, cookie sessions, LAN auto-auth | | 🌐 | Remote access | ngrok support with QR code — access from anywhere | | 🐳 | Docker ready | One-liner container deployment | | ♻️ | Modular codebase | Clean architecture with JSDoc typing (config, state, utils, cdp) |

---

📱 How It Works

┌─────────────┐    CDP (7800)    ┌──────────────┐    HTTPS/WS (4747)    ┌─────────────┐
│ Antigravity  │ ◄──────────────► │  Node Server  │ ◄──────────────────► │   Phone      │
│  (Desktop)   │    DOM snapshot   │  (server.js)  │    mirror + control  │  (Browser)   │
└─────────────┘                  └──────────────┘                      └─────────────┘

The server connects to Antigravity via the Chrome DevTools Protocol (CDP), captures the chat DOM in real-time, and streams it to your phone over WebSocket. Actions on your phone (sending messages, switching models) are executed back on the desktop via CDP.

Zero impact on your desktop — the mirroring is read-only until you interact. No plugins, no extensions, no Antigravity modifications needed.

---

🪟 Multi-Window Management

Manage multiple Antigravity instances from a single phone:

• Window Selector — Tap 🖥️ to see all open Antigravity windows
• Instant Switching — Select any window, mirrors within 2 seconds
• Smart Filtering — Only shows real editor windows (hides Settings, Launchpad)
• Launch Windows — Spawn new Antigravity instances directly from your phone

---

🚀 Launch Modes

| Feature | Git Clone | NPM Global | Docker | | ------------ | --------------------- | ----------------------------------- | ---------------- | | Basic server | npm start | omni-chat | docker run ... | | QR code | npm run start:local | omni-chat (shows URL) | — | | ngrok tunnel | npm run start:web | omni-chat + npx ngrok http 4747 | — | | SSL setup | npm run setup:ssl | Manual with mkcert | Not needed |

Windows & WSL Integration

# In PowerShell (Run as Administrator)
cd scripts/windows-wsl-remote
./Start-OmniChat.ps1

Context Menu: This script sets up a handy right-click "Open OmniChat & Antigravity" shortcut on Windows that seamlessly launches your project inside WSL. See scripts/windows-wsl-remote/README.md for full instructions.

<details> <summary>📖 Full launch mode details</summary>

Git Clone (full control)

npm start              # Start server directly
npm run start:local    # Start with QR code for Wi-Fi access
npm run start:web      # Start with ngrok tunnel for internet access
npm run setup:ssl      # Generate trusted HTTPS certificates

ngrok (Remote Access)

# Terminal 1
omni-chat

# Terminal 2
npx ngrok http 4747

Full ngrok integration (automatic tunnel + QR code) is available via npm run start:web with NGROK_AUTHTOKEN in .env.

SSL Setup

npm run setup:ssl

Auto-installs mkcert, creates a local CA, and generates trusted certificates → green padlock 🔒

</details>

---

🧰 Remote Work