Overview
Antigravity Manager provides native desktop applications for macOS, Windows, and Linux with full GUI support. Choose from automated installation scripts or manual downloads.System Requirements
Minimum Requirements:
- Memory: 256MB RAM (1GB recommended)
- Storage: 200MB free disk space
- Network: Internet connection for OAuth and API calls
Platform-Specific
- macOS: macOS 10.15+ (supports both Apple Silicon and Intel)
- Windows: Windows 10/11 (64-bit)
- Linux:
- Ubuntu 20.04+ / Debian 11+
- Arch Linux
- AppImage support for other distributions
Quick Install (Recommended)
Linux / macOS
Automatically detects your OS, architecture, and package manager:Advanced Installation Options
Advanced Installation Options
Install Specific Version:Dry Run (Preview Only):
Windows
Run in PowerShell:Package Manager Installation
Manual Installation
Step 1: Download
Download the appropriate package from GitHub Releases:macOS
.dmg - Universal binary (Apple Silicon & Intel)Windows
.msi or .exe installer, or portable .zipLinux
.deb, .rpm, or .AppImageStep 2: Install
- macOS
- Windows
- Linux (DEB/RPM)
- Linux (AppImage)
- Open the downloaded
.dmgfile - Drag “Antigravity Tools” to Applications folder
- If you see “App is damaged” error, run:
macOS Security
Fix “App is damaged” Error
First Launch
After installation:-
Launch the Application
- macOS: Open from Applications folder
- Windows: Use Start Menu or Desktop shortcut
- Linux: Search in application launcher or run
antigravity-tools
-
Configure Settings
- Navigate to Settings → General
- Configure auto-start behavior
- Set up system tray preferences
-
Add Accounts
- Go to Accounts → Add Account
- Follow the OAuth authorization flow
- See Account Management for details
Auto-Start Configuration
Configure Antigravity Manager to start automatically on system boot:- macOS
- Windows
- Linux
The application uses LaunchAgent for auto-start:
- Enable in Settings → General → Auto-start
- Starts minimized to system tray by default
Updates
Antigravity Manager supports automatic updates on all platforms:Automatic Updates
- Navigate to Settings → About
- Toggle Enable automatic update checks
- Set check frequency (daily, weekly, or manual)
Manual Update Check
- Click Check for Updates in Settings → About
- Download progress shown in notification
- Restart prompted when update is ready
Homebrew Users
Troubleshooting
macOS: 'App is damaged' or 'Cannot be opened'
macOS: 'App is damaged' or 'Cannot be opened'
This is a Gatekeeper security feature. Fix with:Or reinstall with Homebrew using
--no-quarantine.Linux: GTK/Wayland crashes
Linux: GTK/Wayland crashes
If the app crashes on Wayland:Or disable tray icon:
Windows: Black window flashing
Windows: Black window flashing
Fixed in v4.1.26+. Update to the latest version:
Too many open files (macOS)
Too many open files (macOS)
The application automatically increases file descriptor limits. If issues persist:
Environment Variables
Disable system tray icon (useful for headless or Wayland sessions)
Force enable tray even on Wayland (may cause crashes)
Use Wayland backend on Linux (default: X11 for stability)
Force X11 backend on Linux
Data Location
Application data is stored in:- macOS:
~/Library/Application Support/antigravity_tools/ - Windows:
%APPDATA%\antigravity_tools\ - Linux:
~/.antigravity_tools/
Next Steps
Add Accounts
Set up OAuth authentication and add accounts
Configure API Proxy
Enable the API proxy service for Claude CLI and other clients
Model Routing
Configure intelligent model routing and mappings
Docker Deployment
Or deploy as a Docker container for servers