Google Antigravity Troubleshooting Guide

Why This Happens:

WSL2 runs in a virtualized network environment. The OAuth redirect token can't find its way back to the WSL instance.

Solutions:

• Use Windows native version: Install Antigravity directly on Windows, not in WSL2
• Port forwarding: Forward port 9222 from Windows to WSL2
• WSLg: Ensure WSLg is enabled for GUI app support
• Manual token: Copy the auth token from browser URL and paste manually if prompted

The most reliable setup:

1. Install Antigravity on Windows (not in WSL)
2. Open your WSL2 project folder via Windows path: \\wsl$\Ubuntu\home\user\project
3. Antigravity will use Windows authentication but can access WSL2 files

If you must run Antigravity inside WSL2:

# In Windows PowerShell (as Admin):
netsh interface portproxy add v4tov4 \
  listenport=9222 listenaddress=0.0.0.0 \
  connectport=9222 connectaddress=$(wsl hostname -I)

# In WSL2, set BROWSER to point to Windows:
export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"

• Personal Gmail (@gmail.com): Highest success rate in WSL2
• Google Workspace: May require admin to approve "Experimental Google AI Services"
• Region matching: Your Windows region, Google account region, and IP should all match

Solutions:

• Run the installer as Administrator (right-click → Run as administrator)
• When Windows Defender blocks: Click "More info" → "Run anyway"
• Add exception in Windows Security → Virus & threat protection → Exclusions
• Ensure you have at least 2GB free disk space
• Install Visual C++ Redistributable if missing
• Important: Install to default location - custom paths may cause login issues

Solutions:

• Go to System Settings → Privacy & Security → scroll down
• Find "Google Antigravity was blocked" → Click "Open Anyway"
• Alternatively: Right-click app → Open → Click "Open" in dialog
• M1/M2/M3 Macs: Ensure you downloaded the ARM version, not Intel
• Intel Macs on Apple Silicon require Rosetta 2: softwareupdate --install-rosetta

Minimum Requirements:

• glibc >= 2.28
• glibcxx >= 3.4.25

Ubuntu/Debian:

sudo apt update && sudo apt upgrade
sudo apt install libgtk-3-0 libnotify4 libnss3 libxss1 \
                 libxtst6 xdg-utils libatspi2.0-0 libdrm2 \
                 libgbm1 libasound2

Fedora/RHEL:

sudo dnf install gtk3 libnotify nss libXScrnSaver \
                 libXtst xdg-utils at-spi2-core alsa-lib

Arch Linux Warning:

Antigravity has known issues on Arch: processes may not terminate properly on close, and large file indexing can fill disk space. Monitor with htop.

Solutions:

• Verify extension is installed: chrome://extensions
• Ensure extension is enabled (toggle should be blue)
• Check that Antigravity desktop app is running
• Click extension icon → "Reconnect to Antigravity"
• Restart Chrome completely (close all windows)
• Check firewall isn't blocking localhost connections

Solutions:

• Grant all requested permissions during installation
• Check extension permissions: chrome://extensions → Details → Permissions
• Enable "Allow access to file URLs" if working with local files
• For incognito mode: Enable "Allow in incognito"
• Some enterprise sites block extensions - check with IT

Solutions:

• Remove and reinstall the extension
• Clear extension cache: chrome://extensions → Remove → Reinstall
• Update Chrome to the latest version
• Disable other conflicting extensions temporarily
• Check Chrome Task Manager (Shift+Esc) for memory issues

Solutions:

• Wait: Rate limits typically reset after 60 seconds to 1 hour
• Reduce agent count: Limit concurrent agents to 2-3 instead of 5+
• Switch to Flash model: Gemini Flash has higher rate limits than Pro
• Use async mode: Enable async workflows to queue requests
• Check usage: Monitor your quota in Settings → Usage

Solutions:

• Check your billing status and current quota
• Wait until the next billing cycle for quota reset
• Purchase additional quota if available
• Use more efficient prompts to reduce token usage
• Enable caching for repeated queries

Solutions:

• Reduce number of concurrent agents (recommend: max 3)
• Close unused workspaces
• Clear artifact cache: Settings → Storage → Clear Cache
• Disable browser integration if not needed
• Limit context window size: Settings → Models → Context Limit
• Restart Antigravity periodically during long sessions
• Minimum: 8GB RAM recommended (4GB barely works)

Solutions:

• Create .antigravityignore file in project root
• Add large directories: node_modules, .git, build, dist, *.bin, *.model
• Exclude binary files and AI models (>100MB files)
• Clear index cache: Settings → Storage → Clear Index

node_modules/
.git/
dist/
build/
*.bin
*.onnx
*.model
*.weights

Solutions:

• Check your internet connection speed
• Switch to a faster model (Gemini Flash instead of Pro)
• Reduce context size by being more specific in prompts
• Enable response streaming for faster perceived response
• Check server status at status.antigravity.google

Solutions:

• Update to the latest stable version
• Check crash logs: Help → Show Logs
• Disable experimental features
• Increase system RAM if below 8GB
• Reset to default settings: Settings → Advanced → Reset
• Clean reinstall if crashes persist

# Windows
Settings → Apps → Google Antigravity → Uninstall

# macOS
rm -rf ~/Library/Application\ Support/Antigravity
rm -rf ~/Library/Caches/com.google.antigravity

# Linux
rm -rf ~/.antigravity
rm -rf ~/.config/antigravity

• Path length limit: Enable long paths via Group Policy or Registry
• Windows Defender: Add Antigravity folder to exclusion list
• PowerShell execution: Set execution policy: Set-ExecutionPolicy RemoteSigned
• WSL integration: See WSL2 section above for authentication issues
• Install location: Use default install path to avoid permission issues

• M1/M2/M3 compatibility: Use ARM version for best performance
• Rosetta: Intel version requires Rosetta 2 on Apple Silicon
• Permissions: Grant Full Disk Access in System Settings → Privacy
• Command line tools: Run xcode-select --install first
• Keychain: Allow Antigravity access when prompted

• Wayland: May need to force X11 mode: --ozone-platform=x11
• AppImage permissions: chmod +x antigravity.AppImage
• Sandbox issues: Run with --no-sandbox flag if needed (not recommended for security)
• Font rendering: Install Microsoft fonts for better UI
• Arch Linux: Known issues with zombie processes - use htop to monitor

Solutions:

• Check internet connection is stable
• Verify firewall allows outbound HTTPS (port 443)
• Test connectivity: curl https://antigravity.google
• Try different DNS servers (8.8.8.8, 1.1.1.1)
• Disable VPN temporarily to test
• Increase timeout: Settings → Network → Request Timeout

Solutions:

• Request IT to whitelist: *.antigravity.google, *.googleapis.com, *.google.com
• Configure proxy settings: Settings → Network → Proxy
• Use enterprise SSO if available
• Check if SSL inspection is breaking connections - may need to add certificate

Solutions:

• Auto-detect proxy: Settings → Network → Auto-detect
• Set environment variables: HTTP_PROXY and HTTPS_PROXY
• Test: curl -x proxy:port https://antigravity.google
• Bypass proxy for local: Add localhost, 127.0.0.1 to no_proxy