Antigravity Mobile

     █████╗ ███╗   ██╗████████╗██╗ ██████╗ ██████╗  █████╗ ██╗   ██╗██╗████████╗██╗   ██╗
    ██╔══██╗████╗  ██║╚══██╔══╝██║██╔════╝ ██╔══██╗██╔══██╗██║   ██║██║╚══██╔══╝╚██╗ ██╔╝
    ███████║██╔██╗ ██║   ██║   ██║██║  ███╗██████╔╝███████║██║   ██║██║   ██║    ╚████╔╝
    ██╔══██║██║╚██╗██║   ██║   ██║██║   ██║██╔══██╗██╔══██║╚██╗ ██╔╝██║   ██║     ╚██╔╝
    ██║  ██║██║ ╚████║   ██║   ██║╚██████╔╝██║  ██║██║  ██║ ╚████╔╝ ██║   ██║      ██║
    ╚═╝  ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝  ╚═══╝  ╚═╝   ╚═╝      ╚═╝

    ███╗   ███╗ ██████╗ ██████╗ ██╗██╗     ███████╗
    ████╗ ████║██╔═══██╗██╔══██╗██║██║     ██╔════╝
    ██╔████╔██║██║   ██║██████╔╝██║██║     █████╗
    ██║╚██╔╝██║██║   ██║██╔══██╗██║██║     ██╔══╝
    ██║ ╚═╝ ██║╚██████╔╝██████╔╝██║███████╗███████╗
    ╚═╝     ╚═╝ ╚═════╝ ╚═════╝ ╚═╝╚══════╝╚══════╝

Control your Antigravity IDE desktop coding assistant from your phone.

Monitor agent tasks, approve commands, and switch active models — remotely.

✨ Features

• Mobile Dashboard — Responsive, glassmorphic dark-themed UI with real-time system stats (CPU, RAM, Disk)
• Model Switcher — Switch the active AI model (Gemini, Claude, GPT) in your Antigravity IDE from your phone
• Live Agent Console — Stream step-by-step IDE agent execution thoughts and logs to your phone in real-time
• Mobile Approvals — Approve or reject terminal commands requested by your IDE agent directly from your phone screen
• Offline Fallback — Automatically falls back to local PC desktop prompts if the mobile server is offline
• Remote Toggle — Turn remote mode on/off to save tokens when coding locally

Installation

pip install antigravity-mobile

That's it! Now run antigravity-mobile to see the welcome screen.

[!TIP] Windows Path Issue: If you receive an error saying 'antigravity-mobile' is not recognized as an internal or external command, it means your Python scripts directory is not in your system PATH. You can bypass this by running the tool directly as a Python module:

python -m antigravity_remote

(You can replace antigravity-mobile with python -m antigravity_remote for all commands below).

Uninstallation

If you wish to completely remove the tool, you can uninstall it via pip:

pip uninstall antigravity-mobile -y

Quick Start

Step 1: Setup

Run the interactive setup wizard to generate your secure access PIN and configure agent rules:

antigravity-mobile setup

Step 2: Start the Server

Launch the FastAPI dashboard server on all interfaces:

antigravity-mobile start --host 0.0.0.0 --port 8000

Step 3: Get a Public URL

Expose your local server to the internet so your phone can reach it (requires Node.js):

npx localtunnel --port 8000

This will give you a public URL like https://xyz.loca.lt.

Step 4: Open on Your Phone

1. Open the localtunnel URL on your mobile browser
2. Enter your access PIN (shown during setup)
3. You're in! Start monitoring and controlling your IDE agent remotely 🎉

Step 5: Instruct the AI Agent

To tell your Antigravity IDE agent to start outputting logs and routing command confirmations to your phone, copy and paste this prompt into your Antigravity IDE Chat Panel:

Please read the remote monitoring rules in .agents/AGENTS.md and follow them. I have started the server and want to monitor your steps remotely. Also, check if my Python scripts directory is in my system/user PATH, and if not, add it automatically. Finally, read config.json to print my access PIN and let me know.

📖 All Commands

Usage Examples

Turn off remote mode when coding locally

antigravity-mobile remote --off

This disables all remote logging, status updates, and mobile approval prompts — saving tokens and resources.

Turn it back on when leaving your desk

antigravity-mobile remote --on

Start everything in one go

# Terminal 1: Start the server
antigravity-mobile start --host 0.0.0.0 --port 8000

# Terminal 2: Expose to internet
npx localtunnel --port 8000

⚙️ IDE Configuration (Optional)

To enable silent command execution on your PC (so approvals go to your phone instead of popping up on the desktop), update your Antigravity IDE User Settings:

1. Open: C:\Users\<YOU>\AppData\Roaming\Antigravity IDE\User\settings.json
2. Add:

   {
       "antigravity.autoApprove": true,
       "antigravity.autonomyLevel": "full"
   }
   

3. Press Ctrl + Shift + P → Developer: Reload Window

Security

• PIN Authentication — A secure 6-digit PIN is generated on first setup. Mobile clients must authenticate with this PIN before accessing any features.
• Token-Based Sessions — After PIN login, all API requests use a session token.
• Command Approval — Remote commands require explicit user confirmation before execution.
• Offline Fallback — If the server goes offline, the agent automatically falls back to local PC prompts instead of hanging.

Project Structure

antigravity-mobile/
├── antigravity_remote/
│   ├── cli.py              # CLI with welcome screen, setup wizard, and server commands
│   ├── server.py           # FastAPI server with WebSocket dashboard
│   ├── agent_daemon.py     # Background polling daemon for remote commands
│   ├── agent_approve.py    # Mobile approval helper with offline fallback
│   ├── task_runner.py      # Background subprocess runner
│   └── templates/
│       └── index.html      # Mobile-responsive glassmorphic dashboard
├── .agents/
│   ├── AGENTS.md           # Agent logging & mobile approval rules
│   └── skills/
│       └── remote_control/
│           └── SKILL.md    # Remote loop skill for AI agents
├── pyproject.toml          # Package metadata & CLI entrypoints
└── README.md

License

MIT