# ๐Ÿ“ฑ OmniAntigravity Remote Chat ### Your AI coding session shouldn't end when you leave your desk.
Control your AI from the couch

![Version](https://img.shields.io/badge/version-1.2.0-6366f1) ![Node](https://img.shields.io/badge/node-22%2B-10b981) ![CI](https://github.com/diegosouzapw/OmniAntigravityRemoteChat/actions/workflows/ci.yml/badge.svg) ![License](https://img.shields.io/badge/license-GPL--3.0-blue) [![npm](https://img.shields.io/npm/v/omni-antigravity-remote-chat?color=cc3534&logo=npm)](https://www.npmjs.com/package/omni-antigravity-remote-chat) [![npm downloads](https://img.shields.io/npm/dm/omni-antigravity-remote-chat?color=blue&logo=npm)](https://www.npmjs.com/package/omni-antigravity-remote-chat) [![Docker](https://img.shields.io/docker/pulls/diegosouzapw/omni-antigravity-remote-chat?color=2496ED&logo=docker&logoColor=white)](https://hub.docker.com/r/diegosouzapw/omni-antigravity-remote-chat) **Mirror your Antigravity (Windsurf) AI chat on your phone in real-time.**
**Send messages. Switch models. Manage windows. All from your mobile browser.** [Get Started](#-get-started) ยท [Screenshots](#-see-it-in-action) ยท [How It Works](#-how-it-works) ยท [Docker](https://hub.docker.com/r/diegosouzapw/omni-antigravity-remote-chat) ยท [npm](https://www.npmjs.com/package/omni-antigravity-remote-chat) ๐ŸŒ **Available in:** ๐Ÿ‡บ๐Ÿ‡ธ English | ๐Ÿ‡ง๐Ÿ‡ท [Portuguรชs (Brasil)](README.pt-BR.md) | ๐Ÿ‡ช๐Ÿ‡ธ [Espaรฑol](README.es.md) | ๐Ÿ‡ซ๐Ÿ‡ท [Franรงais](README.fr.md) | ๐Ÿ‡ฎ๐Ÿ‡น [Italiano](README.it.md) | ๐Ÿ‡ท๐Ÿ‡บ [ะ ัƒััะบะธะน](README.ru.md) | ๐Ÿ‡จ๐Ÿ‡ณ [ไธญๆ–‡ (็ฎ€ไฝ“)](README.zh-CN.md) | ๐Ÿ‡ฉ๐Ÿ‡ช [Deutsch](README.de.md) | ๐Ÿ‡ฎ๐Ÿ‡ณ [เคนเคฟเคจเฅเคฆเฅ€](README.in.md) | ๐Ÿ‡น๐Ÿ‡ญ [เน„เธ—เธข](README.th.md) | ๐Ÿ‡บ๐Ÿ‡ฆ [ะฃะบั€ะฐั—ะฝััŒะบะฐ](README.uk-UA.md) | ๐Ÿ‡ธ๐Ÿ‡ฆ [ุงู„ุนุฑุจูŠุฉ](README.ar.md) | ๐Ÿ‡ฏ๐Ÿ‡ต [ๆ—ฅๆœฌ่ชž](README.ja.md) | ๐Ÿ‡ป๐Ÿ‡ณ [Tiแบฟng Viแป‡t](README.vi.md) | ๐Ÿ‡ง๐Ÿ‡ฌ [ะ‘ัŠะปะณะฐั€ัะบะธ](README.bg.md) | ๐Ÿ‡ฉ๐Ÿ‡ฐ [Dansk](README.da.md) | ๐Ÿ‡ซ๐Ÿ‡ฎ [Suomi](README.fi.md) | ๐Ÿ‡ฎ๐Ÿ‡ฑ [ืขื‘ืจื™ืช](README.he.md) | ๐Ÿ‡ญ๐Ÿ‡บ [Magyar](README.hu.md) | ๐Ÿ‡ฎ๐Ÿ‡ฉ [Bahasa Indonesia](README.id.md) | ๐Ÿ‡ฐ๐Ÿ‡ท [ํ•œ๊ตญ์–ด](README.ko.md) | ๐Ÿ‡ฒ๐Ÿ‡พ [Bahasa Melayu](README.ms.md) | ๐Ÿ‡ณ๐Ÿ‡ฑ [Nederlands](README.nl.md) | ๐Ÿ‡ณ๐Ÿ‡ด [Norsk](README.no.md) | ๐Ÿ‡ต๐Ÿ‡น [Portuguรชs (Portugal)](README.pt.md) | ๐Ÿ‡ท๐Ÿ‡ด [Romรขnฤƒ](README.ro.md) | ๐Ÿ‡ต๐Ÿ‡ฑ [Polski](README.pl.md) | ๐Ÿ‡ธ๐Ÿ‡ฐ [Slovenฤina](README.sk.md) | ๐Ÿ‡ธ๐Ÿ‡ช [Svenska](README.sv.md) | ๐Ÿ‡ต๐Ÿ‡ญ [Filipino](README.phi.md)

## ๐Ÿ˜ค 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. ```bash 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
| Main Interface | Model Selection | Ready to Chat | | :--------------------------------------------------: | :----------------------------------------------------: | :---------------------------------------------------: | | | | | | Premium dark UI with live sync | Switch between Gemini, Claude, GPT | Send messages from your phone |
--- ## โšก Get Started ### One command โ€” zero config: ```bash npx omni-antigravity-remote-chat ``` ### Or install globally: ```bash npm install -g omni-antigravity-remote-chat omni-chat ``` ### Or run with Docker: ```bash 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): ```bash 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 ```bash # 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](scripts/windows-wsl-remote/README.md) for full instructions.
๐Ÿ“– Full launch mode details ### Git Clone (full control) ```bash 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) ```bash # 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 ```bash npm run setup:ssl ``` Auto-installs [mkcert](https://github.com/FiloSottile/mkcert), creates a local CA, and generates trusted certificates โ†’ green padlock ๐Ÿ”’
--- ## ๐Ÿงฐ Remote Workspace The mobile workspace is no longer just a side panel. In `1.2.0` it includes: - **Files** for browsing and previewing project files - **Terminal** for remote commands and output streaming - **Git** for status, staging, commit and push shortcuts - **Assist** for supervisor-backed chat with action buttons - **Stats** for live session analytics - **Timeline** for persistent screenshot history - **Screen** for the live screencast stream This makes the phone UI useful for both passive monitoring and active intervention without leaving the browser. --- ## ๐Ÿ”‘ Configuration ```bash cp .env.example .env ``` | Variable | Default | Description | | ------------------------- | ------------------ | --------------------------------------------- | | `APP_PASSWORD` | `antigravity` | Authentication password | | `PORT` | `4747` | Server port | | `COOKIE_SECRET` | _(auto-generated)_ | Secret for cookie signing | | `AUTH_SALT` | _(auto-generated)_ | Additional salt for auth tokens | | `WORKSPACE_ROOT` | repo root | Root exposed in Files, Terminal and Git | | `AUTO_TUNNEL_PROVIDER` | _(optional)_ | Set to `cloudflare` for quick tunnel startup | | `SUPERVISOR_SUGGEST_MODE` | `false` | Queue supervisor actions for human review | | `SUPERVISOR_MAX_QUEUE` | `10` | Maximum pending suggestions | | `QUOTA_ENABLED` | `false` | Enable background quota polling | | `QUOTA_POLL_INTERVAL` | `300000` | Quota polling interval in ms | | `SCREENSHOT_ENABLED` | `false` | Enable automatic screenshot timeline capture | | `SCREENSHOT_INTERVAL` | `60000` | Timeline capture interval in ms | | `SCREENSHOT_MAX` | `100` | Maximum screenshots persisted on disk | | `NGROK_AUTHTOKEN` | _(optional)_ | For remote access via ngrok | --- ## ๐Ÿ› ๏ธ Troubleshooting | Issue | Solution | | ------------------- | ------------------------------------------------------------ | | "CDP not found" | Launch Antigravity with `--remote-debugging-port=7800` | | "EADDRINUSE" | Change `PORT` in `.env`, or stop the process using that port | | Phone can't connect | Ensure same Wi-Fi network and check firewall | | "Syncing..." stuck | Wait 2-3s for CDP contexts to populate after window switch | --- ## ๐Ÿ“ Project Structure ``` โ”œโ”€โ”€ src/ โ”‚ โ”œโ”€โ”€ server.js # Main server (Express + WS + CDP actions) โ”‚ โ”œโ”€โ”€ config.js # Constants, env vars, container IDs โ”‚ โ”œโ”€โ”€ state.js # Shared state + JSDoc type definitions โ”‚ โ”œโ”€โ”€ cdp/ โ”‚ โ”‚ โ””โ”€โ”€ connection.js # CDP discovery & connection โ”‚ โ””โ”€โ”€ utils/ โ”‚ โ”œโ”€โ”€ network.js # getLocalIP, isLocalRequest, getJson โ”‚ โ”œโ”€โ”€ process.js # killPortProcess, launchAntigravity โ”‚ โ””โ”€โ”€ hash.js # Hash utility โ”œโ”€โ”€ public/ # Mobile chat interface โ”œโ”€โ”€ launcher.js # QR code + ngrok launcher โ”œโ”€โ”€ scripts/ # SSL, context menu installers โ”œโ”€โ”€ test/ # Validation test suite โ”œโ”€โ”€ Dockerfile # Docker support โ””โ”€โ”€ .github/workflows/ # CI + auto-release + Docker Hub ``` --- ## ๐Ÿ“Š Star History Star History Chart --- ## ๐Ÿค Contributing 1. Fork the repository 2. Create your feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines. --- ## ๐Ÿ™ Acknowledgments Special thanks to **[Krishna Kanth B](https://github.com/krishnakanthb13)** โ€” the original creator of the Windsurf mobile chat concept that inspired this project. OmniAntigravity builds upon that foundation with multi-window management, robust CDP handling, NPM/Docker packaging, and a premium mobile-first UI. --- ## ๐Ÿ“„ License GPL-3.0 โ€” see [LICENSE](LICENSE) for details. ---
Built with โค๏ธ for developers who code from everywhere
github.com/diegosouzapw/OmniAntigravityRemoteChat