How to install the Antigravity extension in VS Code

In this tutorial, you install the official Antigravity extension in VS Code, confirm your eligible account, and run your first test without confusing the extension with the IDE or the terminal.

In this article you will see:

• What the extension adds to VS Code.
• Which prerequisites to check before installation.
• How to install via the interface or VS Code command.
• How to sign in, test a task, and troubleshoot common issues.

What is the Antigravity extension for VS Code

The extension brings Google's agentic capabilities into VS Code. The official documentation describes a dedicated panel for chatting with agents, reviewing code diffs, and tracking multi step tasks.

This is different from Antigravity IDE, which is a standalone environment, and Antigravity CLI, which runs in the terminal. The extension is the path for those who want to stay in VS Code and add the Antigravity workflow to the editor they already use.

The installation can also set up the local component agy. For that reason, do not start by downloading files from unofficial sources or mixing instructions from older versions. First install the extension published by Google and follow the flow it presents.

For a broader view of the platform, see the article Google Antigravity: is the agent platform worth it?.

Check the Antigravity prerequisites

You need Visual Studio Code installed and an account with Antigravity entitlement. Current documentation also lists Gemini Enterprise among the access requirements, so confirm your account eligibility before troubleshooting an installation error.

The requirement is service access, not operating system. Google's extensions page describes the VS Code extension as compatible with macOS, Linux and Windows.

Use an open VS Code window in a test project. If the folder comes from someone else or a downloaded repository, keep Workspace Trust in restricted mode until you understand what actions the agent can perform.

Install the extension in VS Code

Open VS Code and follow these steps:

1. Open the Extensions tab with Ctrl+Shift+X on Windows or Linux, or Cmd+Shift+X on macOS.
2. Search for Google Antigravity.
3. Confirm that the displayed publisher is Google.
4. Click Install.
5. Look for the Antigravity icon in the Activity Bar.

The official extension page on Visual Studio Marketplace lists the identifier used by VS Code. If you prefer to install from the terminal, use:

$ code --install-extension Google.google-antigravity

The command installs the package by the Marketplace identifier. Do not swap the publisher for a similar name and do not use a VSIX file found on a third party site.

Google's own documentation recommends installing the extension from the Marketplace. The visual flow is useful because it lets you check the publisher, description and origin before confirming.

Log in and start the first task

After installation, click the Antigravity icon in the Activity Bar. The panel should guide you through login and initial setup. Authentication is unified across Antigravity surfaces, but the available features still depend on your account and its associated permissions.

Start with a read and planning request, not a big change. For example: “analyze src/, list the entry points and propose a small improvement; do not change files yet”.

Read the plan before allowing tools. Then ask for a small change in a test file and review the inline diff. Run the project tests manually before accepting the change.

The goal of the first test is to confirm three things: the agent can read the correct workspace, you understand when a tool will be used, and the result appears as a reviewable change in the editor.

Check scope before expanding use

Agents can receive workspace context and perform authorized actions. Before using a real repository, remove sensitive files from the test, review environment variables, and confirm which tools the panel offers.

Do not confuse “the agent saw the file” with “the agent can publish the change”. Keep Git clean, review git diff and run tests before committing or opening a pull request.

If you already work with multiple agents inside VS Code, the guide to agents in VS Code 1.145 helps organize sessions and pending changes. The Antigravity extension does not eliminate the need for human review.

If the extension does not appear or start

If search does not show Google Antigravity, check that VS Code is up to date and that you are using the official Marketplace. If the publisher is not Google, stop the installation and validate the source.

If the icon appears but login does not proceed, the first point is account eligibility. Review the entitlement and associated organization instead of trying parallel installs.

If installation finishes but the project does not load, confirm the open folder and Workspace Trust status. For additional integrations, consult the guide to MCP in VS Code and enable only servers whose origin you know.

When to combine Antigravity with bridgecode

The Antigravity extension solves agent access inside VS Code. bridgecode solves another layer: tracking multiple agents, separating roles, and organizing a planning, execution and review flow.

If the task is a question or a small change, start with Antigravity alone. If different specialists are working in parallel, coordinate your agents in a single flow in bridgecode and keep each step reviewable.