antigravity-mobile 0.3.4

A remote monitor and scheduler CLI tool for Antigravity 2.0 IDE

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

Command	Description
antigravity-mobile	Show welcome banner & quick-start guide
antigravity-mobile setup	Interactive first-time setup wizard
antigravity-mobile init	Generate config & security PIN
antigravity-mobile start	Start the FastAPI dashboard server
antigravity-mobile remote --on	Enable remote monitoring mode
antigravity-mobile remote --off	Disable remote monitoring (saves tokens)
antigravity-mobile remote --status	Check if remote mode is on or off

---

💡 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

---

📦 Publishing Updates

# Install build tools
pip install build twine

# Build distribution
python -m build

# Upload to PyPI
python -m twine upload dist/antigravity_mobile-*

---

License

MIT