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
Что это?Это мобильный монитор и пульт дистанционного управления в реальном времени для ваших настольных ИИ-сессий Antigravity: чат зеркалится на телефон, и вы можете удалённо отправлять сообщения, останавливать генерации или подтверждать действия.
Это приложение для телефона или сервер, запускаемый на ПК?Это сервер на Node.js, который вы запускаете на ПК; телефон просто открывает URL в браузере (или сканирует QR-код), чтобы просматривать и управлять зеркалируемой сессией — устанавливать приложение на телефон не нужно.
Как это запустить?Запустите Antigravity с включённой удалённой отладкой, откройте или начните чат, затем выполните поставляемый стартовый скрипт (bat для Windows, sh для macOS/Linux): он запустит сервер и покажет QR-код для подключения телефона через локальный Wi-Fi.
Что нужно установить перед запуском?Требуется Node.js 16+, а скрипты запуска автоматически создают виртуальное окружение Python для остальных зависимостей; также нужно, чтобы само настольное приложение Antigravity уже работало с активным чатом.
Работает ли зеркалирование без какой-либо настройки на стороне компьютера?Нет, серверу для захвата снимков нужна активная сессия чата в Antigravity; без неё вы получите ошибки «chat container not found», а доступ с телефона за пределами домашнего Wi-Fi требует настройки провайдера туннеля.
На каких операционных системах можно запускать сервер?Скрипты запуска и инструкции по настройке предоставляются для Windows, macOS и Linux.
Передаёт ли это серверу мои учётные данные или логин к ИИ-провайдеру?Нет, он лишь зеркалирует интерфейс через Chrome DevTools Protocol и никогда не извлекает OAuth-токены и не обращается к API ИИ-провайдера напрямую; все запросы по-прежнему исходят от вашего официального настольного приложения.
Как добраться до телефона вне домашнего Wi-Fi?В .env настраивается провайдер туннеля: ngrok (нужен токен бесплатного аккаунта), Cloudflare Tunnel (нужен установленный cloudflared) или Pinggy (аккаунт не нужен, работает поверх SSH). Удалённый доступ затем защищён паролем приложения или магической ссылкой входа через QR.
Что я реально могу делать удалённо с телефона, кроме наблюдения?Можно отправлять сообщения, останавливать генерации, переключать ИИ-модели (Gemini/Claude/GPT) или режимы (Fast/Planning), подтверждать или отклонять запросы разрешений, разворачивать блоки размышлений и начинать новые чаты — всё двунаправленно синхронизируется с компьютером.
Это совершенно новый проект или он на чём-то основан?Это доработанный форк/расширение исходного проекта «Antigravity Shit-Chat» от gherghett с добавленными возможностями вроде HTTPS, глобальных туннелей и переработанного мобильного интерфейса.
Насколько быстрое зеркалирование между компьютером и телефоном?Снимки захватываются через Chrome DevTools Protocol со временем менее 100 мс, с интервалом опроса около 1 секунды для почти мгновенной синхронизации между компьютером и телефоном.
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