Chapter 2. Installing the App and First Cleanup — Opening a Folder as a Project
Required Read this to follow this stage.One-line summary: Install the Antigravity app, sign in with your Google Account, and open your organizer folder as a Project. Start by assigning tasks in Planning mode (plan first), read the plan, and click Proceed to run it.
This guide has not yet been tested on the app screen. Button names on the screen use the exact English names from the official docs. It is fine if your screen looks a little different. Find a button with a similar name and follow along. You can find the results of actually running it in Chapter 3 (running in the terminal).[1]
Installing and Signing In
- Download the installer for your computer from antigravity.google/download. On macOS, open
Antigravity.dmgand drag it into the Applications folder.[2] - Open the app and click Sign in. When your browser opens, sign in with your personal Google Account.[3]
Your usage limits and available models depend on the plan (Free, Pro, or Ultra) of the account you sign in with (Chapter 1).
Quick check
What is the right way to sign in to the Antigravity app?
Opening a Folder as a Project
Agents in the Antigravity app work inside Projects. A project defines which folders the agent can touch and what permissions it has.[4]
- Click the New Project icon (a folder with a plus sign) in the left sidebar.[5]
- Click Add Folder and choose your organizer folder. A regular folder that is not a Git repository works too.[5:1]
When you send your first instruction, you choose how the agent works.[6]
| Name | What it does |
|---|---|
| Local mode | Work directly in your current folder |
| New worktree mode | Work in a separate, isolated Git workspace |
Source: Antigravity official docs[6:1]
For your organizer folder, choose Local mode. It works right in your current folder, so you can find the result files right away.
We cover permissions (what the agent is allowed to do) in Chapter 4. You don't need to change any settings for now.
More details (click to expand)
Quick check
How do you open the organizer folder in the Antigravity app?
Getting a Plan First, Then Proceeding
When you start a new conversation, you choose one of two modes.[9]
| Name | What it does | When to use |
|---|---|---|
| Planning mode | Make a plan first, then run it | Tasks you are assigning for the first time |
| Fast mode | Run right away without a plan | Small tasks like renaming a file |
Source: Antigravity official docs (excerpted)[9:1]
At first, we recommend Planning mode. When the Implementation plan comes out, read it over. If it looks good, click Proceed in the conversation or at the top of the plan to continue.[10] This plays the same role as Plan Mode (계획 모드) in Claude Code Chapter 5 and /plan in Codex Chapter 4.
When the agent finishes a task, it creates a Walkthrough to summarize what changed.[11]
At first, it is safe to leave it on Request review (waiting for your approval). When the agent makes a plan, it stops and waits until you click Proceed.[12] You choose how you review work in the Agent tab of Settings.[12:1]
More details (click to expand)
At the opposite end, Always proceed runs right away without stopping.[13] It is best not to choose it until you are used to things.
Quick check
What approach does this guide recommend when giving the agent a new kind of task?
Assigning Your First Cleanup
Send the same request you used with the previous two tools.
Turn the memo in inbox/meeting-2026-10-27-weekly.txt into meeting minutes and save it as a new file in the notes/ folder.If you want to point out a specific file, you can type @ and pick it. Pointing to a file does not paste its contents into your prompt. Instead, the agent gets the file path and reads the file when it needs to.[14]
You can see the result of running this same request from the terminal (agy) in Chapter 3. The app and the terminal use the same agent (Chapter 1).
Compare the result with the original. Did all 5 action items make it over? Do the owners and due dates match the memo? Did it make up anything that wasn't in the memo?
Quick check
What happens when you point to a file with @ in the chat box?
Viewing What Changed
The Review pane in the app shows changes in your project's Git repository.[15] The default view is Uncommitted (all changes not yet recorded), so edits you made yourself show up alongside the agent's edits. Pick Agent Edits to see only the files the agent modified in this conversation.[16]
Git is a tool that keeps a record of when and how files changed. The Review pane compares this record with your current files and shows the difference. That is why it is handy to turn your organizer folder into a Git repository (a folder with Git records turned on) too.
- If you followed Claude Code Chapter 3 or Codex Chapter 2, it is already a Git repository.
- If not, you don't need to know any Git commands. Claude Code Chapter 3 shows how to ask the agent, "Turn on change history (Git) for this folder" (optional). This method was checked in Claude Code, so this guide could not confirm whether it works the same way in Antigravity.
The official docs do not mention how the Review pane looks in a folder that does not use Git.
Quick check
In the Review pane, what should you pick to see only the files the agent edited in this chat?
Try It Yourself
- Install the app and sign in.
- Open your organizer folder via New Project → Add Folder.
- Send the request above in Planning mode, read the plan, and click Proceed.
- Compare the resulting meeting minutes with the original memo, and check the modified files in the Review pane.
Up next: In Chapter 3, we test whether Antigravity follows your rules (AGENTS.md) and skills without moving them.
Summary
- Sign in to the app via Sign in → your personal Google Account.
- Open a folder as a project via New Project → Add Folder. Regular folders work too.
- Start with Planning mode and Request review so you can read the plan before clicking Proceed.
- The Review pane shows Git changes. Use Agent Edits to see only the agent's changes.
Glossary
| Term | One-line meaning |
|---|---|
| Project | A bundle of folders and permissions where an agent works |
| Planning mode | A mode where the agent makes a plan first before running tasks |
| Implementation plan | A work plan created by the agent |
| Walkthrough | A summary report created after finishing a task |
Finished this chapter?
Progress is saved only in this browser. See your progress on the full table of contents.
Next chapter: Chapter 3. Rules and Skills — No Need to Move Them
References (16)
This chapter is based on the Antigravity official docs checked on November 1, 2026. This guide has not yet been tested on the app screen. ↩︎
Antigravity official docs, "Get started". "Open the downloaded
Antigravity.dmgdisk image and drag Antigravity into your Applications folder." antigravity.google (checked on 2026-11-01) ↩︎Antigravity official docs, "Authenticate". "Click Sign in to open the browser authentication flow." / "Complete the browser-based OAuth flow using your personal Google Account (Free, Pro, or Ultra plan)." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Get started". "Agents operate within Projects, which define the repository boundaries, file scopes, and security permissions for your workspaces." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Get started". "Click the New Project icon (folder with a plus sign) in the left sidebar." / "Click Add Folder to select one or more local Git repositories or working directories." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Get started". "Local mode: The agent operates directly in your active folders." / "New worktree mode: The agent operates in an isolated Git worktree." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Projects". "New worktree mode: Creates a new Git worktree for the conversation. Best for complex tasks, keeping your active working folder untouched and preventing parallel subagents from conflicting." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Projects". "Settings: When a project is created, it starts with the Inherit Global permission preset, following your global permission settings, with read and write access to all of your project’s folders." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Artifact review". "Planning mode: The agent plans thoroughly before executing tasks." / "Fast mode: The agent executes tasks directly without a dedicated planning phase." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Implementation plan". "You can click Proceed either in the conversation or in the artifact header to immediately continue with the agent’s plan." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Walkthrough". "The agent creates walkthrough artifacts when it completes task implementation. This type of artifact includes a concise summary of the changes made to remind you of what happened in the active conversation." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Artifact review". "You can customize the review workflow in the Agent tab of the Settings pane." / "The agent always halts and requests your explicit approval before proceeding with proposed changes:" antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Artifact review". "The agent never halts for manual review and immediately proceeds with executing its plans:" antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Mentions and quoting". "Mentioning a file or folder doesn’t paste its contents into your prompt." / "| A file or folder | Its full path. The agent reads it when it needs to. |" antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Review changes". "In the Antigravity App, the Review pane shows the changes in your project’s Git repository, including the agent’s edits." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Review changes". "| Agent Edits | The files the agent modified in this conversation, whether or not they’re committed. |" / "| Uncommitted | Staged and unstaged changes in your working tree, grouped under Staged Changes and Changes. This is the default. |" antigravity.google (checked on 2026-11-01) ↩︎