antigravity_phone_chat README

The project's README from github.com/krishnakanthb13/antigravity_phone_chat. As one markdown file: README.md.

Antigravity Phone Connect

Antigravity Phone Connect 📱

License: GPL v3

Antigravity Phone Connect is a high-performance, real-time mobile monitor and remote control for your Antigravity AI sessions. It allows you to step away from your desk while keeping full sight and control over your AI's thinking process and generations.

Antigravity Phone Connect

Antigravity Phone Connect

Note: This project is a refined fork/extension based on the original Antigravity Shit-Chat by gherghett.

🚀 Quick Start

💡 Tip: While we recommend starting Antigravity first, the server is now smart enough to wait and automatically connect whenever Antigravity becomes available!

Step 1: Launch Antigravity in Debug Mode

Start Antigravity with the remote debugging port enabled:

Option A: Using Right-Click Context Menu (Recommended)

Option B: Manual Command

antigravity . --remote-debugging-port=9000

Step 2: Open or Start a Chat

💡 The server needs an active chat session to capture snapshots. Without this, you'll see "chat container not found" errors.

Step 3: Run the Server

Windows:

Double-click start_ag_phone_connect.bat

macOS / Linux:

chmod +x start_ag_phone_connect.sh   # First time only
./start_ag_phone_connect.sh

The script will:

Step 4: Connect Your Phone (Local Wi-Fi)

  1. Ensure your phone is on the same Wi-Fi network as your PC
  2. Open your mobile browser and enter the URL shown in the terminal
  3. If using HTTPS: Accept the self-signed certificate warning on first visit

🌍 NEW: Global Remote Access (Web Mode)

Access your Antigravity session from anywhere in the world (Mobile Data, outside Wi-Fi) with secure passcode protection.

Step 1: Choose a Tunnel Provider

You can use ngrok (requires account), Cloudflare Tunnel (requires cloudflared), or Pinggy (free SSH tunnel, no account/install needed).

Option A: ngrok (Default)

  1. Get an ngrok Token: Sign up for free at ngrok.com and get your "Authtoken".
  2. Setup: Update your .env file:
    TUNNEL_PROVIDER=ngrok
NGROK_AUTHTOKEN=your_token_here

Option B: Cloudflare Tunnel

  1. Install cloudflared: Follow the official guide to install cloudflared on your system.
  2. Setup: Update your .env file:
    TUNNEL_PROVIDER=cloudflare

Option C: Pinggy Tunnel

  1. No Install Required: Pinggy works via SSH and the Python SDK. The launcher will automatically install the pinggy pip package.
  2. Setup: Update your .env file:
    TUNNEL_PROVIDER=pinggy
    (Optional) You can add PINGGY_TOKEN=your-token for a persistent subdomain if you have a Pinggy account.

Step 2: Configuration

  1. Automatic Configuration: Simply run any launcher script. They will detect if .env is missing and automatically create it using .env.example as a template.
  2. Manual Setup: Alternatively, copy .env.example to .env manually and update the values:
    copy .env.example .env   # Windows
cp .env.example .env     # Mac/Linux
    Ensure you set a secure password:
    APP_PASSWORD=your_secure_passcode

Usage

The script will launch the server and provide a Public URL (e.g., https://abcd-123.ngrok-free.app).

Two Ways to Connect:

  1. Magic Link (Easiest): Scan the Magic QR Code displayed in the terminal. It logs you in automatically!
  2. Manual:
    • Open the URL on your phone.
    • Enter your APP_PASSWORD to log in.

💡 Tip: Devices on the same local Wi-Fi still enjoy direct access without needing a password.

For a secure connection without the browser warning icon:

Option 1: Command Line

node generate_ssl.js

Option 2: Web UI

  1. Start the server on HTTP
  2. Look for the yellow "⚠️ Not Secure" banner
  3. Click "Enable HTTPS" button
  4. Restart the server when prompted

After Generating:

  1. Restart the server - it will automatically detect and use HTTPS.
  2. On your phone's first visit:
    • You'll see a security warning (normal for self-signed certs).
    • Tap "Advanced" → "Proceed to site".
    • The warning won't appear again!

macOS: Adding Right-Click "Quick Action" (Optional)

Since macOS requires Automator for context menu entries, follow these steps manually:

  1. Open Automator (Spotlight → type "Automator").
  2. Click File → New and select Quick Action.
  3. At the top, set:
    • "Workflow receives current" → folders
    • "in" → Finder
  4. In the left sidebar, search for "Run Shell Script" and drag it to the right pane.
  5. Set "Shell" to /bin/zsh and "Pass input" to as arguments.
  6. Paste this script:
    cd "$1"
antigravity . --remote-debugging-port=9000
  7. Save the Quick Action with a name like Open with Antigravity (Debug).
  8. Now you can right-click any folder in Finder → Quick Actions → Open with Antigravity (Debug).

🏗️ Architecture Infographic

Repo Infographic

🛡️ Shielding & Account Safety

This tool is designed with a "Local-First" security model.

✨ Features

📂 Documentation

For more technical details, check out:

License

Licensed under the GNU GPL v3.
Copyright (C) 2026 Krishna Kanth B (@krishnakanthb13)

Star History

Star History Chart

antigravity_phone_chat (krishnakanthb13/antigravity_phone_chat)

Searching Database…

810 ·GitHub
Antigravity_phone_chat
What is this?It is a real-time mobile monitor and remote control for your Antigravity AI desktop sessions, mirroring the chat to your phone and letting you send messages, stop generations, or approve actions remotely.
Is this an app I install on my phone, or a server I run on my PC?It is a Node.js server you run on your PC; your phone just opens a browser URL (or scans a QR code) to view and control the mirrored session, no phone app install needed.
How do I get it running?Launch Antigravity with remote debugging enabled, open or start a chat, then run the provided startup script (bat for Windows, sh for macOS/Linux) which starts the server and shows a QR code to connect your phone over local Wi-Fi.
What do I need installed before running it?Node.js 16+ is required, and the launcher scripts auto-create a Python virtual environment for other dependencies; you also need the Antigravity desktop app itself already running with an active chat.
Does mirroring work without any setup on the desktop side?No, the server needs an active chat session in Antigravity to capture snapshots; without one you'll get 'chat container not found' errors, and reaching your phone outside your home Wi-Fi requires setting up a tunnel provider.
Which operating systems can I run the server on?Launcher scripts and setup instructions are provided for Windows, macOS, and Linux.
Does this expose my account credentials or AI provider login to the server?No, it only mirrors the UI via Chrome DevTools Protocol and never extracts OAuth tokens or talks to the AI provider's API directly; all requests still come from your official desktop app.
How do I reach my phone from outside my home Wi-Fi?You configure a tunnel provider in .env: ngrok (needs a free account token), Cloudflare Tunnel (needs cloudflared installed), or Pinggy (no account needed, works over SSH). Remote access is then protected by an app password or a magic QR login link.
What can I actually do remotely from my phone besides watching?You can send messages, stop generations, switch AI models (Gemini/Claude/GPT) or modes (Fast/Planning), approve or deny permission prompts, expand thinking blocks, and start new chats, all synced bi-directionally with the desktop.
Is this a brand new project or based on something else?It is a refined fork/extension of the original 'Antigravity Shit-Chat' project by gherghett, with added features like HTTPS, global tunneling, and a redesigned mobile UI.
How fast is the mirroring between desktop and phone?Snapshots are captured via Chrome DevTools Protocol with sub-100ms performance, using roughly a 1-second polling interval for near-instant sync between desktop and mobile.
What are similar projects?dsh-bridge, dsh-remote-web-gateway, dsh-pocket, dsh-mobile, browser-harness, hapi, Crucix, adhdev
Which topics is it in?cloudflare-tunnel, cdp, https, remote-control, qr-code, antigravity, tunnel, express, chrome, websocket, real-time, monitoring
Creator
krishnakanthb13
Size
15.6 MB
Stars
810
Updated
CommitJun 16Releasev0.3.2Apr 07
Age
9mo
Commits · 90 Days