Getting Started

Welcome to Google Antigravity! Follow the instructions below to get started on your preferred surface.

Antigravity 2.0

Download Antigravity 2.0

Visit antigravity.google/download to download Google Antigravity 2.0. Select your operating system below:

Platform	Download
macOS	Download for Apple SiliconDownload for Intel Requirements: macOS versions with Apple security update support. This is typically the current and two previous versions. Min Version 12 (Monterey), X86 is not supported.
Windows	Download for x64Download for ARM64 Requirements: Windows 10 (64 bit)
Linux	Download for x64Download for ARM64 Requirements: glibc >= 2.28, glibcxx >= 3.4.25 (e.g. Ubuntu 20, Debian 10, Fedora 36, RHEL 8)

Installation

You may get a notification asking whether you want to “Keep Both” or “Replace” Antigravity, select “Replace.” You will be prompted to re-install the IDE during installation, should you choose to. If you do not install it now and would like to re-download it later, you can do so here.

Creating a Project

Agents work within Projects, which define the boundaries of the folders and repositories they can access.

1. Click the folder with a ”+” icon in the left sidebar.
2. Click on “New Project”.
3. Click Add Folder to associate one or more local folders or Git repositories. Adding multiple folders provides your agent with full cross-repository context.
4. Click Create.
5. (Optional) Configure your Project’s settings. Each Project maintains its own isolated settings and security policies that the agent respects.

Starting an Agent

Once your Project is created, you can spawn an agent to start working on tasks.

1. Type your goal or instruction in the chat input (e.g., “Help me add a new feature”) and press Enter.
2. Choose a Mode in the setup modal to boot up your agent:
   • Local Mode: The agent operates directly in your active folders.
   • New Worktree Mode: The agent operates in an isolated Git worktree.

Basic Navigation

Action	macOS	Windows / Linux
Open Conversation Picker	⌘K	Ctrl + K
Open File Search	⌘P	Ctrl + P
Focus Input	⌘L	Ctrl + L
New Conversation	⌘N	Ctrl + N
Next/Previous Conversation	⌥ Up / Down	Alt + Up / Down

Slash Commands

Slash Command	Description
/goal	Run until the specified task is completely finished, not asking for intermediate input from the user.
/grill-me	Before starting to implement, ask questions back to align on the specific details of the plan.
/schedule	Run an instruction as a one-time timer in the future or on a recurring schedule (via Scheduled Tasks).
/browser	Explicit slash command controlling browser debugging behaviors in Google Chrome.

Antigravity CLI

Welcome to Antigravity CLI! This guide provides a direct, high-level developer roadmap to install the client, launch the Terminal User Interface (TUI), and begin collaborating with autonomous agents.

Roadmap checklist

Complete the following sequential steps to launch your first session:

1. Install the client (fast path)

   Run the appropriate fast-path command for your operating system:

   macOS / Linux:

   curl -fsSL https://antigravity.google/cli/install.sh | bash

   Windows (PowerShell):

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

   Windows (CMD):

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

   By default, the installer registers the agy binary to your platform-specific directory:

   • macOS / Linux: ~/.local/bin/agy
   • Windows: C:\Users\<username>\AppData\Local\agy\bin (where <username> represents your active Windows profile name).

   Note

   Advanced Setup: For detailed enterprise credentials configuration, secure keyring auth permissions, proxy setups, or troubleshooting installation issues, consult the Installation & Auth Guide.

2. Launch the TUI inside a project

   Open a fresh terminal window, navigate to your target project codebase directory, and execute the launcher command:

   agy

3. Complete the first-launch setup

   On your very first launch, the TUI walks you through a brief interactive setup:

   • Color Scheme: Select your preferred visual theme (Solarized, Dark, Solarized Light, or standard Terminal colors).
   • Rendering Mode: Choose Alt-Screen mode (alternate buffer with full-screen scrolling) or Inline mode (sequential stream integrated with your terminal’s history).
   • Workspace Trust: Confirm that you trust the repository directory. Once confirmed, the agent indexes the files and stands ready.

4. Run your first agent task

   Type the following instruction in the prompt box at the bottom of your TUI screen and press Enter:

   Write a simple python script to fetch web page text

   The agent reads the workspace, reasons about the task, and proposes a plan. For a detailed step-by-step tutorial on reviewing code and running test commands inside the TUI, follow the Tutorial Guide.

Related resources

Optimize your local environment configurations and master advanced collaboration tools:

• Best Practices: Master verification loops, planning phases, rule files, and session checkpoints.
• Troubleshooting: Resolve common path, keyring, or SSH forwarding errors.
• CLI Reference: Dense reference sheets cataloging all slash commands, shortcuts, and JSON keys.

Antigravity IDE

Download Antigravity IDE

Please visit antigravity.google/download to download Antigravity IDE.

Available platforms and minimum versions:

• macOS: macOS versions with Apple security update support. This is typically the current and two previous versions. Min Version 12 (Monterey), X86 is not supported
• Windows: Windows 10 (64 bit)
• Linux: glibc >= 2.28, glibcxx >= 3.4.25 (e.g. Ubuntu 20. Debian 10, Fedora 36, RHEL 8)

The application will prompt when updates are available: