✨ Features
🔄 Real-Time Mirroring
- 1-Second Polling: Near-instant sync keeps your phone's display updated with your desktop session.
- WebSocket Notifications: Efficient push updates notify your phone only when content changes.
- Smart Content Hashing: Minimizes bandwidth by detecting actual UI changes.
🎮 Remote Control
- Send Messages: Compose and send prompts to your AI directly from your phone.
- Stop Generations: Halt long-running AI generations with a single tap.
- Mode Switching: Toggle between Fast and Planning modes remotely.
- Model Selection: Switch between AI models (Gemini, Claude, GPT) on the fly.
🧠 Thought Expansion
- Remote Click Relay: Tap on "Thinking..." or "Thought" blocks on your phone to expand them on your desktop IDE.
- Full Reasoning Access: Peek into the AI's internal reasoning process from anywhere in your home.
🔁 Bi-Directional Sync
- State Synchronization: Changes made on your desktop (model, mode) are automatically reflected on your phone.
- Force Refresh: Manually trigger a full sync with the Refresh button when needed.
🎨 Premium Mobile UI
- Dark-Themed Design: Sleek, modern slate-dark interface optimized for mobile viewing.
- Touch-Optimized: Large tap targets and responsive layouts for comfortable mobile interaction.
- Aggressive CSS Inheritance: VS Code theme-agnostic rendering ensures consistent mobile appearance.
📁 Context Menu Integration
- Windows: Right-click any folder and select "Open with Antigravity (Debug)" for instant debugging sessions.
- Linux (Nautilus/GNOME): Native Nautilus script integration for seamless right-click access.
- macOS: Step-by-step Quick Action guide for Automator-based integration.
🛠️ Context Menu Management Scripts
- Install/Remove: Easy toggle for context menu entries.
- Backup: Automatic backup before making registry/script changes.
- Restart: One-click Explorer (Windows) or Nautilus (Linux) restart to apply changes.
🖥️ Platform Support
| Platform | Launcher Script | Context Menu Script |
|---|---|---|
| Windows | start_ag_phone_connect.bat
| install_context_menu.bat
|
| macOS | start_ag_phone_connect.sh
| Manual Automator setup |
| Linux | start_ag_phone_connect.sh
| install_context_menu.sh
|
📡 API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/health
| GET | Server status, CDP connection state, and uptime |
/snapshot
| GET | Latest captured HTML/CSS snapshot |
/app-state
| GET | Current Mode and Model selection |
/send
| POST | Send a message to Antigravity chat |
/stop
| POST | Stop current AI generation |
/set-mode
| POST | Change mode (Fast/Planning) |
/set-model
| POST | Change AI model |
/remote-click
| POST | Trigger desktop click event |
/debug-ui
| GET | Serialized UI tree for debugging |
📋 Requirements
- Node.js: v16.0.0 or higher
- Network: Phone and PC must be on the same Wi-Fi network
- Antigravity: Running with
--remote-debugging-port=9000
📦 Dependencies
| Package | Version | Purpose |
|---|---|---|
express
| ^4.18.2 | HTTP server for UI and API |
ws
| ^8.18.0 | WebSocket for real-time updates |
🔒 Security
- Local Network Only: By design, the app is constrained to your LAN. Your project snapshots and AI tokens are never exposed to the public internet.
- No Authentication Required: Simplified setup for trusted home/office networks.
- CDP Sandboxing: DOM snapshots are cloned before capture to prevent interference with your desktop session.
Full Changelog: https://github.com/krishnakanthb13/antigravity_phone_chat/commits/v0.1.0