Skip to content

This page was translated from the Korean original with AI and may contain errors.

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 the AGENTS.md and .agents/skills files 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]

SurfaceWhat it doesIn this guide
Antigravity AppGive tasks to the agent and watch it work on your desktopFrom Chapter 2
Antigravity CLI (agy)Use it in the terminalChapter 6
Editor extension & Antigravity IDEUse it inside a code editorNot covered
SDKBuild agents with PythonNot 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.

PlanUsage limit (quota)
Free (accounts without Google AI Pro or Ultra)Refreshes weekly
Google AI ProRefreshes every 5 hours up to a weekly limit
Google AI UltraMost 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)
  • It is available only in supported countries. South Korea is on the list.[11]
  • Accounts managed by a company or school are not personal accounts. So an administrator must allow access before you can use it.[12]

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.

ModelFreeProUltra
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 CodeCodexAntigravity
DesktopCode tab in the Claude appCodex in the ChatGPT appStandalone app
Rules fileCLAUDE.mdAGENTS.mdAGENTS.md, GEMINI.md
Skills in this folder.claude/skills.agents/skills.agents/skills
Calling a skill/name$name/name
Terminalclaude -pcodex execagy -p
Free practiceNoLimitedYes

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.

  1. Chapter 2: Install the app, open your folder as a project, and hand over your first cleanup task.
  2. Chapter 3: Test whether Antigravity follows your rules and skills without moving or renaming them.
  3. Chapters 4–5: Compare permissions, undo, planning, and scheduled tasks with Claude Code and Codex.
  4. Chapter 6: Learn the terminal command agy -p and its pitfalls.
  5. 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.md and .agents/skills from the exact same names and locations as Codex.

Glossary ​

TermOne-line meaning
AntigravityGoogle's coding agent tool
agyAntigravity's terminal program
QuotaThe amount of usage you get during a set period
GEMINI.mdAnother 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)
  1. 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) ↩︎

  2. 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) ↩︎

  3. 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) ↩︎

  4. 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) ↩︎

  5. Antigravity official docs, "Authenticate". "Signing in on one local surface shares your credentials across your local environment." antigravity.google (checked on 2026-11-01) ↩︎

  6. 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) ↩︎

  7. 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) ↩︎

  8. 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) ↩︎

  9. Antigravity official docs, "FAQ". "Personal Google Accounts (such as @gmail.com addresses) can use Google Antigravity on any plan, including the free tier." antigravity.google (checked on 2026-11-01) ↩︎

  10. Antigravity official docs, "FAQ". "Currently, Antigravity is unavailable to users under 18." antigravity.google (checked on 2026-11-01) ↩︎

  11. Antigravity official docs, "FAQ". "Google Antigravity is available in the following countries and territories." / "South Korea" antigravity.google (checked on 2026-11-01) ↩︎

  12. 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) ↩︎

  13. Antigravity official docs, "Choose a model". "You can switch models at any time and choose a thinking level (Low, Medium, or High) 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) ↩︎

  14. 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) ↩︎

  15. Antigravity official docs, "Choose a model". "* Will be removed on November 2, 2026." antigravity.google (checked on 2026-11-01) ↩︎

  16. Antigravity official docs, "Customization discovery". "Workspace: the .agents/ folder in your project, plus AGENTS.md and GEMINI.md files." antigravity.google (checked on 2026-11-01) ↩︎