omni-antigravity-remote-chat

📱 OmniAntigravity Remote Chat

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

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 · 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

😤 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

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:

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.

📖 Full launch mode details

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 🔒

🧰 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

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

🤝 Contributing

• Fork the repository
• Create your feature branch (git checkout -b feature/amazing-feature)
• Commit your changes (git commit -m 'Add amazing feature')
• Push to the branch (git push origin feature/amazing-feature)
• Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

🙏 Acknowledgments

Special thanks to Krishna Kanth B — 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 for details.

_{Built with ❤️ for developers who code from everywhere
github.com/diegosouzapw/OmniAntigravityRemoteChat}