Google Antigravity on Windows: install, CLI and setup

To use Google Antigravity on Windows 10 (64-bit) or Windows 11, download the Antigravity App or the Antigravity IDE installer from antigravity.google/download and run it. The App has installers for x64 and ARM64. For the terminal, install the agy CLI from PowerShell or Command Prompt. On Windows 11, Orbtile shows each Antigravity App conversation on a keypad or phone.

Windows system requirements and Antigravity surfaces

The Antigravity App, the CLI, IDE extensions and the SDK share one sign-in.

Install the Antigravity App, IDE and editor extensions on Windows

Antigravity App on Windows 10 and Windows 11

Download the x64 (Antigravity-x64.exe) or ARM64 (Antigravity-arm64.exe) installer from antigravity.google/download. Run it and follow the setup wizard.

Agents work inside Projects:

• Click New Project in the left sidebar, then Add Folder to choose your repositories or folders, then Create.
• Choose Local mode to work in your active folders, or New worktree mode to work in an isolated Git worktree.

Windows keyboard shortcuts in the App:

• Ctrl + N starts a new conversation, and Ctrl + K opens the conversation picker.
• Alt + Up and Alt + Down move to the previous or next conversation.
• Ctrl + P searches files, and Ctrl + Shift + P opens commands.
• Ctrl + L focuses the message box, and Ctrl + F finds text.

Standalone Antigravity IDE and Windows editor extensions

Download the standalone Antigravity IDE installer from antigravity.google/download and run it. The IDE downloads new versions in the background. It then prompts Restart to Update, or Install Update for a system-wide installation.

In the standalone IDE, the agent runs in the Agent side panel on the right:

• Ctrl+L moves focus to the Agent panel. From the editor, it also adds the selected lines to your prompt as context.
• Ctrl+Shift+L starts a new conversation.
• The Toggle Agent button in the title bar shows or hides the panel.

To install Antigravity in an editor you already use:

• VS Code 1.90+: press Ctrl+Shift+X, search Google Antigravity and click Install.
• Visual Studio 2026 (17.8+): in Extensions > Manage Extensions, download Google Antigravity and restart Visual Studio to finish the VSIX install.
• In Visual Studio, Ctrl+, Ctrl+A opens the Antigravity tool window.
• IntelliJ-based IDEs 2026.2.1+: open JetBrains AI > Settings > Agents, search Antigravity and click Install.
• Eclipse 2026-06+: in Help > Eclipse Marketplace, install Google Antigravity and restart Eclipse.
• In Eclipse, Ctrl + Alt + K toggles the chat view.

See Google Antigravity IDE: editor, agents and permissions.

Install the Antigravity CLI (agy) in PowerShell or CMD

In Windows PowerShell, run:

irm https://antigravity.google/cli/install.ps1 | iex

In Command Prompt (CMD), run:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Both put the binary in C:\Users\<username>\AppData\Local\agy\bin. Check the install with agy --version.

Initial terminal setup and first CLI session

On first launch, pick a colour scheme (Dark, Solarized Dark, Solarized Light or your terminal default). Then choose the Alt-Screen or Inline rendering mode and confirm workspace trust.

Run agy to start the interactive interface. Run agy -i "prompt" to start a session with an initial prompt, or agy -p "prompt" to run one prompt and print the response.

• Shift + Tab switches between the auto, plan, default and accept-edits modes.
• /diff opens the diff viewer, and Ctrl + R opens Artifact Review.
• Tab inspects file diffs and tool details, and Ctrl + O expands or collapses a tool pill.
• /agents switches subagents, and /statusline configures the status line.
• /usage shows your credit usage and quotas.
• Ctrl + C interrupts generation, and Ctrl + D or /exit ends the session.

Fix PATH and self-updater lock errors on Windows

If agy returns a "command not found" error, its folder is not on your PATH. Google's fix is to open PowerShell as Administrator and append the folder to your User Path:

[System.Environment]::SetEnvironmentVariable("Path", [System.Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Program Files\Google\antigravity-cli", "User")

Google's example adds C:\Program Files\Google\antigravity-cli. The installer's default folder is C:\Users\<username>\AppData\Local\agy\bin, so use whichever folder holds agy. Then restart your terminal.

The background self-updater keeps a 15-minute marker (last_check.timestamp) and a lock file (update.lock) in ~/.gemini/antigravity-cli/updater/. A crashed updater can leave the lock behind. If agy hangs or warns about update.lock:

• Delete ~/.gemini/antigravity-cli/updater/update.lock.
• Make sure your user can write to %LOCALAPPDATA%\agy\bin.
• Set AGY_CLI_DISABLE_AUTO_UPDATE=true in your shell profile to turn off auto-updates.

See Google Antigravity CLI: commands, settings and permissions.

Sign in and share credentials on Windows

The Antigravity App, the CLI, IDE extensions and the SDK use one sign-in. Signing in on one of them shares your credentials with the others on your computer.

To compare what personal Google AI plans and Gemini Enterprise licences cost and include, see Google Antigravity pricing: plans, quotas, models and credits.

When you launch agy, it looks for a saved token profile in Windows Credential Manager. If it finds one, it signs you in silently. Otherwise your default browser opens:

• Sign in with a personal Google Account.
• Or choose Business account, then Continue with Google Cloud or Advanced WIF Configuration.
• For a business account, confirm the linked project, or pick Other and enter a GCP Project ID and a location: global, us or eu.
• To switch projects or regions, log out and sign in again.
• Run /logout in the CLI to clear your saved credentials from Credential Manager.

The CLI can also authenticate in two other ways:

• Gemini API key: set "modelProvider": "gemini" in ~/.gemini/antigravity-cli/settings.json, then set GEMINI_API_KEY.
• The CLI ignores GOOGLE_API_KEY and .env files, and GEMINI_API_KEY alone has no effect.
• Application Default Credentials: run gcloud auth application-default login --project {GCP_PROJECT}.
• Then set AGY_ADC_AUTH=true, or set "enableAdc": true under userSettings in ~/.gemini/config/config.json.

Where Antigravity stores settings, rules and MCP configs

Global files live under ~/.gemini in your Windows user profile. Workspace files live in your project, mostly under .agents.

Workspace and global rule files

• AGENTS.md and GEMINI.md do not use YAML frontmatter.
• Every .md file in a rules/ folder must start with YAML frontmatter that sets a valid trigger.
• trigger takes model_decision, always_on, glob or manual, and the CLI does not support manual.
• Files nested in subfolders of .agents/rules/ are ignored unless you register them in .agents/rules.json.
• Rule files are truncated at 24,000 bytes, counted after @[label](path) includes are expanded.
• Global and always_on rules share a 20,000-token budget.
• Over that budget, the largest files become pointers that the agent reads on demand.

Model Context Protocol (MCP) servers

In the App, manage MCP servers under Customizations > Installed > MCP Servers, where Copy Config File Path gives the file's location. In the IDE, click … at the top of the agent side panel and select MCP Servers. In the CLI, type /mcp.

Each mcpServers entry in mcp_config.json sets command for a local stdio server, with optional args, env and cwd. A remote server uses serverUrl and must use the Streamable HTTP transport. By default, connecting times out after 300 seconds and each tool call after 180 seconds. A positive timeoutSeconds value replaces both limits. Tool schemas load lazily unless you set "eager": true for a tool. See Google Antigravity MCP servers: set up and manage tools.

Windows terminal sandboxing and permission rules

Antigravity's Windows terminal sandbox runs agent shell commands in an AppContainer. It is built on native Windows features, so there are no VMs or Docker images to manage.

Windows 11 24H2 sandbox requirements and boundaries

• The sandbox needs Windows 11 24H2 or later with the August 2026 update or later.
• On Windows 10 or earlier Windows 11 builds, enableTerminalSandbox and --sandbox have no effect.
• Without the sandbox, proceed-in-sandbox behaves like request-review, and auto mode is not offered.
• Your saved settings are kept and take effect once the sandbox is available.
• Sandboxed commands can write to workspace folders, temporary folders and common build caches.
• Sensitive files such as ~/.ssh and .env are blocked, and other files in your user profile stay hidden.
• Folders outside your user profile are readable but not writable.
• Sandboxed commands have no network access, apart from domains allowed under read_url.

Presets, execution modes and Windows path normalisation

In the App, choose a preset in Settings > General > Global Permissions > Permission Preset:

• Default runs commands in the sandbox without prompting and asks before running outside it.
• Auto also lets safe, reversible commands run outside the sandbox, while risky ones still ask.
• On Windows, Auto needs App v2.26.0 or later and is not available for business or enterprise accounts.
• Request Review turns the sandbox off and asks before every command.
• Turbo runs all commands without restrictions.

In the CLI, agy --mode=auto starts auto mode, which turns the sandbox on. On Windows, auto mode needs CLI v1.4.4 or later and a personal account. To force the sandbox for one session, run agy --sandbox. To keep it on, set this in ~/.gemini/antigravity-cli/settings.json:

{
  "enableTerminalSandbox": true,
  "toolPermission": "proceed-in-sandbox"
}

With proceed-in-sandbox, sandboxed commands run without prompting, and commands that need to run outside the sandbox still ask.

Permission rules take the form action(target) and follow Deny > Ask > Allow priority. Google's examples allow command(git), command(regex:npm run (build|lint|test)) and write_file(src/), and deny command(rm -rf).

• On Windows, paths lose their drive letter and backslashes become forward slashes before rules are checked.
• A command with constructs that can hide other commands, such as $(...), runs without a prompt only if a rule matches the whole line.
• The regex: prefix lets a rule match commands with a regular expression.

See Google Antigravity multi-agent: run parallel coding agents.

Watch Antigravity sessions on Windows with Orbtile

Logitech's Logi Options+ supports the MX Creative Console from version 1.83 and the MX Keypad from version 2.07. It runs on Windows 10 and later, but not on ARM64. Downloading extra plugins needs a Logi ID.

Orbtile drives the MX Creative Keypad's nine LCD keys and two page buttons over USB by itself, without Logi Options+ or an account. It runs on Windows 11 (x64) or an Apple silicon Mac with macOS 14 or later. Orbtile Mobile can be the pad instead, on Android 8.0 or later or an iPhone with iOS 17 or later.

On Windows 11, install Orbtile from the Microsoft Store, with winget install --id 9P9HNFZHR8NG --source msstore, or with the .msi installer, which needs no administrator rights.

• Orbtile follows conversations in the Antigravity desktop app, giving each a key with its title, state and live response text.
• A conversation waiting on a question moves to the front.
• To answer questions with numbered options from the keypad, turn on Settings > Agents > Antigravity > Answer questions from the keypad.
• Then tap your picks and hold Send, for up to four questions with two to four choices each.
• Permission prompts and written answers stay on your computer.
• Antigravity IDE and CLI sessions do not appear automatically.
• A CLI hook script can report each session to Orbtile's local Adapter API, which you turn on in Settings > Agents.
• The same pad also shows Claude Code, Codex, ZCode and Kimi Code sessions.
• Press Ctrl+Alt+Win+K or hold both page buttons for 1.5 seconds to hand the keypad back to Logi Options+.

See Antigravity notifications: know when an agent is waiting, Use the Logitech MX Creative Keypad without Logi Options+ and Show any script or agent on a keypad with the Orbtile Adapter API.