Documentation

Everything you need to set up, configure, and master AG Remote — the mobile Agent Manager for Antigravity IDE. Go from zero to full remote control in under a minute.

Quick Start Guide

Get up and running in 3 steps. The entire setup takes less than 60 seconds.

How It Works

AG Remote creates a secure bridge between your iPhone and your Mac's Antigravity IDE. The system consists of three components:

Requirements

Native Chat Interface

AG Remote provides a fully native iOS chat experience built with SwiftUI. It mirrors the desktop Antigravity Agent Manager, letting you send prompts, receive AI responses with full markdown rendering, and view code blocks with syntax highlighting.

Force-Approve (Ghost Override)

When your AI staff encounters a permission block in the IDE — such as file system operations or command execution — it pauses and waits for manual approval. Normally, this requires you to be physically at your Mac.

With Force-Approve, you can grant that permission with a single tap from your iPhone. The staff immediately resumes work. No walking back to your desk required.

Live Screen Capture

Want to see what your Mac looks like right now? Tap the camera icon in the chat toolbar to instantly capture a screenshot of your Mac's screen. The image is delivered to your iPhone in seconds.

This is invaluable for checking if the staff is editing the right file, if a browser preview looks correct, or if the IDE is in an unexpected state.

Smart IDE Activity Feed

The Activity Feed is a 4-phase real-time indicator that shows exactly what your staff is doing at any moment:

An elapsed timer tracks how long the current phase has been active, with smart escalation prompts if things take unusually long.

Remote IDE Restart

If the Antigravity IDE becomes unresponsive or stuck, you can restart it directly from your iPhone. The restart process includes:

1. Gracefully shutting down the current IDE instance
2. Re-launching Antigravity with the correct configuration
3. Automatically bringing the IDE window to the front
4. Reconnecting the staff session

Real-time progress is displayed on your iPhone throughout the restart process so you always know the current state.

Auto-Confirm Mode

Toggle Auto-Confirm to let your staff automatically approve safe operations without manual intervention. When enabled, the staff will continue working autonomously, only pausing for truly high-risk operations.

You can toggle this on/off at any time from the chat toolbar. Ideal for long-running tasks where you trust the staff's judgment.

AI Model Switching

Switch between AI models directly from your iPhone. Use a fast, lightweight model for quick questions and a more powerful model for complex multi-file refactoring tasks. The model switch takes effect immediately on the next message.

Multi-Modal Chat

Attach images directly from your iPhone camera or photo library to any message. Use cases include:

• Photographing a UI bug on another device
• Snapping a whiteboard wireframe for the staff to implement
• Sharing a screenshot of an error from another app
• Providing visual design references

Images are uploaded securely and the staff receives them as context alongside your text prompt.

Chat History & Tab Control

Manage your full staff session history from the sidebar. You can:

• Switch tabs — Jump between active Antigravity chat sessions
• Rename conversations — Tap the edit icon to rename any session
• Start new chats — Create fresh staff sessions from mobile
• View history — Scroll through past conversations with full context

Sync Connection

The Sync button in the sidebar performs a comprehensive health check of your iPhone-to-IDE connection. It:

• Verifies the Desktop Host is reachable
• Refreshes system information and connection status
• Reloads all active conversations and history
• Updates the current AI model selection

A visual indicator shows syncing progress and confirms when everything is in harmony.

Advanced UI Automation

When operating in Auto-Confirm mode, AG Remote doesn't just guess where to click. It features a proprietary engine that recursively maps complex IDE UI layers.

• Automatically intercepts IDE confirmation dialogs
• Simulates natural user interactions to bypass UI lockouts
• Instantly tracks and approves operations deep within the IDE environment

Adaptive Recovery

If the IDE flags an action as "High Traffic", AG Remote automatically deploys smart recovery strategies, silently recovering the session without forcing you to solve captchas or wait out penalties.

Device Management & Revocation

AG Remote Desktop offers full access control over paired devices. From the Host Dashboard, you can instantly Revoke any connected iPhone.

When a device is revoked, the system immediately cuts off the session, sends a REST-based force-logout command to the mobile app, and destroys the auth state. Connection attempts by revoked devices are systematically dropped on arrival.

Desktop Host Setup

The Desktop Host is a lightweight companion app that runs on your Mac. It creates the secure bridge between your iPhone and the Antigravity IDE.

Workspace Mapping

During the Desktop Host setup, you are prompted to select your Workspaces. This is a critical configuration step. AG Remote dynamically installs background sync agents specifically inside the directories you select.

Recommendation: To guarantee seamless connectivity across all your projects without having to constantly update configurations, we highly recommend selecting a global root folder (e.g., /Users/name/Projects) during setup instead of selecting individual project folders one by one.

iOS App Setup

Download AG Remote from the App Store and sign in with your account.

QR Pairing

QR Pairing establishes a secure, end-to-end encrypted connection between your iPhone and your Mac. The QR code contains encrypted handshake credentials that are exchanged locally — never transmitted over the internet.

Connection Issues

Frequently Asked Questions