Chapter 1. What Antigravity Is and How It Differs from the First Two Tools
Required Read this to follow this stage.One-line summary: Antigravity is an AI tool made by Google that works directly inside a folder on your computer. It comes as a desktop app and a terminal program called
agy. Two things set it apart from the first two tools. You can use all features even with a free Google Account, and it reads theAGENTS.mdand.agents/skillsfiles you made in the Codex stage right as they are.
This chapter is based on the Antigravity official docs (antigravity.google/docs) checked on November 1, 2026. Features and menu names change often.
Four Surfaces
Antigravity comes in four forms depending on where you use it.[1]
| Surface | What it does | In this guide |
|---|---|---|
| Antigravity App | Give tasks to the agent and watch it work on your desktop | From Chapter 2 |
Antigravity CLI (agy) | Use it in the terminal | Chapter 6 |
| Editor extension & Antigravity IDE | Use it inside a code editor | Not covered |
| SDK | Build agents with Python | Not covered |
Source: Antigravity official docs (summarized for this guide)[1:1][2][3]
The app and the CLI run the same agent, so most features work in both places.[4] If you sign in on one surface, the other surfaces on your computer share that same login.[5]
Quick check
How is the Antigravity app related to the terminal program agy?
All Features, Even on the Free Plan
Antigravity gives all features to all plans. That includes scheduled tasks and the CLI.[6] What changes by plan is your usage limit (quota) and which models you can pick.
| Plan | Usage limit (quota) |
|---|---|
| Free (accounts without Google AI Pro or Ultra) | Refreshes weekly |
| Google AI Pro | Refreshes every 5 hours up to a weekly limit |
| Google AI Ultra | Most generous, refreshes every 5 hours |
Source: Antigravity official docs (selected)[7]
Your quota drops based on how much work the agent does, not how many questions you ask. If the task is simple, you can ask more times.[8]
Here are some examples.
- A small task like "Just fix the typos in this file" uses only a little of your quota.
- A big task like "Read every file in the folder and organize them" uses a lot at once.
Out of the three tools, Antigravity is the only one that lets you use every feature with a free account. Claude Code needs a paid subscription, and the Codex chapters assumed a Plus plan or higher. If you don't have a paid plan yet, you can start practicing right from this stage.
If you have a personal Google Account (like an @gmail.com address), you can start for free.[9] However, you must be 18 or older.[10]
More details (click to expand)
Quick check
What changes when you use Antigravity with a free Google account?
Choosing a Model
In Antigravity, you can choose models from other companies besides Gemini.
You also pick a thinking level (Low, Medium, or High). The thinking level sets how deeply the AI thinks things through before answering. Low answers quickly and suits simple edits, while High thinks longer and suits hard tasks with many connected steps.[13]
Which models you can choose depends on your plan.
| Model | Free | Pro | Ultra |
|---|---|---|---|
| Gemini 3.8 Flash | ✅ | ✅ | ✅ |
| Gemini 4 Argon | ❌ | ✅ | ✅ |
| Claude Sonnet 5.5 | ❌ | ✅ | ✅ |
Source: Antigravity official docs (selected; Claude on Pro excludes trial subscriptions)[14]
If you are on a free account, you can plan on practicing with Gemini 3.8 Flash. You don't need to worry about choosing a model from the start.
More details (click to expand)
The docs note that the Claude 4.6 models previously available on the free plan will be removed on November 2, 2026 (as checked on 2026-11-01).[15] So we used Gemini 3.8 Flash as the model to pick on a free account.
Quick check
Which model does this guide recommend for hands-on practice on a free account after November 2, 2026?
What Is the Same and What Is Different from Claude Code and Codex
| Claude Code | Codex | Antigravity | |
|---|---|---|---|
| Desktop | Code tab in the Claude app | Codex in the ChatGPT app | Standalone app |
| Rules file | CLAUDE.md | AGENTS.md | AGENTS.md, GEMINI.md |
| Skills in this folder | .claude/skills | .agents/skills | .agents/skills |
| Calling a skill | /name | $name | /name |
| Terminal | claude -p | codex exec | agy -p |
| Free practice | No | Limited | Yes |
Source: Summary from this guide (see footnotes in each chapter for sources)
The biggest difference is that you don't need to move anything. Antigravity reads AGENTS.md, GEMINI.md, and the .agents/ folder inside your project folder.[16] Those are the exact same file names and locations you made in the Codex stage. You will test this yourself in Chapter 3.
Quick check
When opening the organizer folder made in the Codex step with Antigravity, what do you need to move?
What You Will Do in This Stage
You will open the organizer folder you finished through Chapter 5 of Codex right as it is in Antigravity. If you skipped Codex, you can download the same starting files from "Practice Materials (연습 자료)" on the Stage 3 Antigravity table of contents.
- Chapter 2: Install the app, open your folder as a project, and hand over your first cleanup task.
- Chapter 3: Test whether Antigravity follows your rules and skills without moving or renaming them.
- Chapters 4–5: Compare permissions, undo, planning, and scheduled tasks with Claude Code and Codex.
- Chapter 6: Learn the terminal command
agy -pand its pitfalls. - Chapter 7: Wrap up costs, data privacy, and safety, and decide how to use the three tools together.
Wrap-Up
- Antigravity comes in four forms: app, CLI, editor, and SDK. The app and the CLI run the same agent.
- All plans include all features. Only the quota and available models differ. The free plan refreshes weekly.
- Anyone 18 or older with a personal Google Account can start for free.
- It reads
AGENTS.mdand.agents/skillsfrom the exact same names and locations as Codex.
Glossary
| Term | One-line meaning |
|---|---|
| Antigravity | Google's coding agent tool |
agy | Antigravity's terminal program |
| Quota | The amount of usage you get during a set period |
| GEMINI.md | Another rules file name that Antigravity reads |
Finished this chapter?
Progress is saved only in this browser. See your progress on the full table of contents.
Next chapter: Chapter 2. Installing the App and First Cleanup
References (16)
Antigravity official docs, "Choose your Antigravity". "Evolved from the Agent Manager into a standalone desktop command center (Antigravity App) alongside native terminal, editor, and programmatic SDK interfaces, Antigravity supports both synchronous interactive pair-programming and asynchronous background agent workflows independent of a single IDE." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Get started". "Install the official Google Antigravity extension for your preferred editor, or download the standalone Antigravity IDE:" antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Google Antigravity SDK". "The Google Antigravity SDK is a Python SDK for building autonomous AI agents powered by Antigravity and Gemini." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Antigravity features". "The Antigravity App and the Antigravity CLI run the same agent, so most features work on both." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Authenticate". "Signing in on one local surface shares your credentials across your local environment." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Plans". "All plans receive the following baseline features:" / "Access to all product features, such as scheduled tasks and the CLI" antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Plans". "The highest, most generous quota, refreshed every five hours" / "A high, generous quota, refreshed every five hours until the weekly limit is reached" / "A meaningful quota, refreshed weekly" antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Plans". "As a result, you receive more prompts when your tasks are straightforward and the agent can complete the work quickly, while more complex tasks consume more quota." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "FAQ". "Personal Google Accounts (such as
@gmail.comaddresses) can use Google Antigravity on any plan, including the free tier." antigravity.google (checked on 2026-11-01) ↩︎Antigravity official docs, "FAQ". "Currently, Antigravity is unavailable to users under 18." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "FAQ". "Google Antigravity is available in the following countries and territories." / "South Korea" antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "FAQ". "Work or school accounts managed by an organization, such as Google Workspace accounts, aren’t personal Google Accounts." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Choose a model". "You can switch models at any time and choose a thinking level (
Low,Medium, orHigh) to balance response speed for quick edits against deeper multi-step reasoning for complex architecture and debugging tasks." antigravity.google (checked on 2026-11-01) ↩︎Antigravity official docs, "Choose a model". Gemini 3.8 Flash, Gemini 4 Argon, and Claude Sonnet 5.5 rows in the model table and "** Available on Google AI Pro for non-trial subscriptions only." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Choose a model". "* Will be removed on November 2, 2026." antigravity.google (checked on 2026-11-01) ↩︎
Antigravity official docs, "Customization discovery". "Workspace: the
.agents/folder in your project, plusAGENTS.mdandGEMINI.mdfiles." antigravity.google (checked on 2026-11-01) ↩︎