TUTORIAL • DEC 8, 2025

The Missing Manual: Running Antigravity on Windows (WSL2)

Official docs say "Mac/Linux Only"? Ignore that. Here is how to get native performance on Windows 11 using WSL2.

Prerequisite: You must have Windows 10 (Version 2004+) or Windows 11 installed.

Step 1: Install WSL2

If you haven't already, open PowerShell as Administrator and run:

wsl --install

Restart your computer. This will install Ubuntu by default.

Step 2: The "Secret" Download Link

Antigravity's Windows installer is technically a Linux binary wrapped in Electron. Do not download the `.exe` (it's buggy). Instead:

  1. Open your Ubuntu terminal.
  2. Download the Linux `.deb` package.
  3. Run `sudo dpkg -i antigravity_latest_amd64.deb`

Step 3: Fixing Graphics (GPU Acceleration)

This is where most users get stuck. If the UI is blurry or lagging, you need to export the display variable. Add this to your `~/.bashrc`:

export GDK_SCALE=1
export GDK_DPI_SCALE=1.25

The "Browser Subagent" Fix

Antigravity's coolest feature is the Browser Agent. But in WSL2, it tries to connect to `127.0.0.1:9222`, which fails because the Linux localhost is isolated from Windows.

The Fix: You need to forward the port. Run this in PowerShell (Admin):

netsh interface portproxy add v4tov4 listenport=9222 listenaddress=0.0.0.0 connectport=9222 connectaddress=[YOUR_WSL_IP]

Troubleshooting

"agy command not found"

The Linux installer sometimes forgets to symlink the CLI tool. Fix it manually:

sudo ln -s /opt/google/antigravity/bin/agy /usr/local/bin/agy

"File Permission Denied"

DO NOT store your project files in `/mnt/c/Users/...`. This effectively kills filesystem performance because of the NTFS translation layer.

Instead, clone your git repos directly into `~/projects` inside the Linux filesystem.