1. Introduction
In this codelab, you will learn about Google Antigravity, an agentic development platform that is designed to help you develop in this era of agents. Antigravity 2.0 serves as your AI agents' central command center, providing a unified platform to launch, monitor, and orchestrate their activities.
With the 2.0 launch, Antigravity is no longer just an Agent Manager integrated with an IDE. It is now a complete ecosystem of products designed for the agent-first era:
- Antigravity: The flagship standalone application for macOS, Linux, and Windows. This is your command center to manage multiple local agents in parallel, run scheduled tasks and more. Unlike its predecessor, the Agent Manager, Antigravity 2.0 is a standalone application that functions independently of an IDE.
- Antigravity IDE: The original fully-featured, agentic IDE remains available (and recommended for developers!). It comes with the agent manager, artifacts, and a deep understanding of your codebase.
- Antigravity CLI: A command-line interface for terminal-based agent interactions. This will not be covered in this tutorial.
- Antigravity SDK: Tools for developers to programmatically integrate Antigravity into their own systems. This will not be covered in this tutorial.
In this codelab, we will heavily focus on Antigravity and touch briefly upon the Antigravity IDE. The other two components, Antigravity CLI and Antigravity SDK, are not covered.
If you are interested in a codelab on Antigravity CLI, which is a terminal-based application, refer to the codelab: Getting Started with Antigravity CLI.
What you'll learn
- Installing and configuring Antigravity.
- Exploring key concepts of Antigravity like working with Agents, Workspaces and more.
- Customizing Antigravity via various settings and as per your preferences.
What you'll need
Antigravity needs to be locally installed on your system. The product is available on Mac, Windows and specific Linux distributions. In addition to your own machine, you will need the following:
- Chrome web browser.
- A Gmail account (Personal Gmail account).
This codelab is designed for users and developers of all levels.
Reporting issues
As you work through the codelab and with Antigravity, you might encounter problems.
For codelab related issues (typos, wrong instructions), please open a bug with the Report a mistake button in the bottom-left corner of this codelab:
For bugs or feature requests related to Antigravity, please report the issue within Antigravity. You can report product feedback by clicking on Settings, available in the bottom left corner of the Antigravity product. And then choosing the option Provide Feedback.
2. Installation
Installing Antigravity
Go to the Google Antigravity download page page. Download the Antigravity application for your operating system (macOS, Linux, or Windows).
Run the installer. It shows the following screen:
Login with your Google account. Complete the authentication and it should show the following:
Click on Open Antigravity. It will show a Security and Data Use policy. Click on Next.
Select a Theme that you like:
Antigravity comes with a set of plugins that work with various Google Developer Tools. These plugins install a set of skills that helps Antigravity to work with various developer tools of Google. Here is a list of plugins that you can optionally choose to install. We won't be covering these plugins in the codelab. Click on Finish.
You should see the Antigravity interface as follows:
Install Antigravity IDE
You can optionally choose to install the Antigravity IDE. Navigate to the Google Antigravity download page. Go to the Antigravity IDE downloads section.
On successful installation of both Antigravity and Antigravity IDE, you will see two icons in your dock: Antigravity (white background) and Antigravity IDE (black grid background).
3. Antigravity Interface
We are ready to get started! Let's focus first on using Antigravity. The initial Antigravity screen is similar to this one:
We will get to the Settings option in the lower left corner, as we go along this tutorial, as we need.
Projects
Let's understand the concept of Projects first in Antigravity. This is key because if you notice the interface in the right pane, it clearly says Select Project and Antigravity uses a project-centric approach to ensure the agents have access to the right files, tools, permissions and more.
A project is a combination of folders defining the environment and the scope of your agent. Instead of forcing an agent to operate within a single folder, a project can work with one or multiple folders (e.g., a frontend and a backend repo), providing your agents with all of the context required for your codebase. All projects have their own isolated agent settings, allowing you to customize different projects' security settings independently.
Let's create our first project. In your home folder on your local machine, create a folder named $HOME/agy2-projects/my-first-project . Note that it does not have to be an empty folder.
We are now going to create our first project in Antigravity by defining what folders constitute the project. In our initial case, it will be one folder.
Click on Select Project → New Project as shown below:
As expected, it asks you to Select folder(s) as shown below:
Click on Add Folder and navigate to select the specific folder i.e. $HOME/agy2-projects/my-first-project
You can still add more folders to the project, as you can notice (via Add Folder), but for now, we can click on the Next button.
This brings up a dialog as shown below. All projects have their own isolated agent settings, allowing you to customize different project security settings independently.
Each project inherits permissions around reviewing artifacts, tools allowed, Model Context Protocol (MCP) Server configuration from a global configuration that is available via Settings in the main interface. However, you can set individually these permissions and more per project, thereby getting a lot more flexibility and keeping the context and tools lean and mean for your specific project.
For now, choose the Default option.
You can also name your project in the next dialog and click Create:
You will now see the following screen. The project shows up on the projects list and also in the chat interface as shown. Notice that you can select the model, pass additional context via the + sign or @ or / actions and more.
Once you greet the agent with a message, it responds accordingly.
We have another request to get the news and it does a good job.
Conversations
In our project (my-first-project), we started a conversation thread and currently there is a series of messages (user message and agent responses) that are present in the thread.
You will see that this conversation thread on the left side grouped under the project.
Now, let's do something interesting and give a name to this conversation thread. Let's call it conv-introduction.
To do that Click on the three vertical dots, next to the conversation. It will show you 3 options. Choose the Rename action.
Give the value conv-introduction or any name that makes sense to you.
Now, if you'd like to have a completely new conversation in the project, click the + (New Conversation in Project) sign next to the project as shown below.
You are now into a totally new conversation.
Let's ask some sports news from across the world. Note that we are still in the my-first-project.
This gives me some news around the sports world and you can notice that now we have two conversation threads in the same project.
Let's rename this conversation to conv-sportsnews. If you'd like to see all the conversations that have happened so far, you can visit the Conversation History in the top left as shown below: