Reorganize AI documentation for Antigravity

firebase.json

@@ -33,9 +33,10 @@
       { "source": "/ai-best-practices/:rest*", "destination": "/ai/best-practices/:rest*", "type": 301 },
       { "source": "/ai-toolkit", "destination": "/ai/ai-toolkit", "type": 301 },
       { "source": "/ai-toolkit/:rest*", "destination": "/ai/ai-toolkit/:rest*", "type": 301 },
-      { "source": "/ai/flutter-ext-for-gemini", "destination": "/ai/gemini-cli-extension", "type": 301 },
+      { "source": "/ai/flutter-ext-for-gemini", "destination": "/ai/antigravity-cli", "type": 301 },
+      { "source": "/ai/gemini-cli-extension", "destination": "/ai/antigravity-cli", "type": 301 },
       { "source": "/ai/best-practices/tool-calls-aka-function-calls", "destination": "/ai/best-practices/tool-calls", "type": 301 },
-      { "source": "/ai/antigravity", "destination": "/ai/coding-assistants", "type": 301 },
+      { "source": "/tools/antigravity", "destination": "/ai/antigravity", "type": 301 },
       { "source": "/ai/gemini-code-assist", "destination": "/ai/coding-assistants", "type": 301 },
       { "source": "/ai/firebase-ai-logic", "destination": "https://firebase.google.com/docs/ai-logic/get-started?platform=flutter", "type": 301 },
       { "source": "/android-release", "destination": "/deployment/android", "type": 301 },

sites/docs/src/content/ai/antigravity-cli.md

@@ -0,0 +1,63 @@
+---
+title: Antigravity CLI
+shortTitle: CLI
+sidenav: ai
+description: Learn how to use the Antigravity CLI for Dart and Flutter.
+---
+
+## Introduction
+
+[Antigravity CLI][] (using the executable command `agy`) is a terminal-based interface (TUI) for the **Antigravity 2.0** agentic coding assistant. It connects directly to your workspace and leverages the **Dart and Flutter MCP server** to help you build, modify, test, and release Flutter applications from the command line.
+
+For individual developers, the Antigravity CLI replaces the legacy Gemini CLI.
+
+[Antigravity CLI]: https://antigravity.google/docs/cli
+
+## Installation
+
+Install the Antigravity CLI on your machine by running the appropriate command for your platform:
+
+### macOS and Linux
+```bash
+curl -fsSL https://antigravity.google/install.sh | bash
+```
+
+### Windows (PowerShell)
+```powershell
+irm https://antigravity.google/install.ps1 | iex
+```
+
+### Windows (Command Prompt)
+```cmd
+winget install Google.AntigravityCLI
+```
+
+After installation, verify that the tool is available on your path by running:
+
+```console
+$ agy --version
+agy version 2.0.0
+```
+
+## Migration from Gemini CLI
+
+If you previously used the Gemini CLI or Gemini CLI extension for Flutter, migrating to the Antigravity CLI is straightforward.
+
+### Automatic Migration
+The first time you run `agy` in your terminal, the tool checks for existing Gemini configuration files (such as `~/.gemini/config/mcp_config.json` or legacy environment variables). If found, the tool asks if you would like to automatically migrate your settings, preferences, and API configuration.
+
+### Manual Migration
+If you want to migrate your plugins and history manually, or if you skipped the automated setup, run the import plugin tool command:
+
+```bash
+agy plugin import gemini
+```
+
+This command parses your local Gemini configuration and copies its configurations over to your active Antigravity profile.
+
+## Workspace configuration and rules
+
+Like the legacy Gemini CLI tool, Antigravity CLI respects custom development guidelines and configurations stored in your workspace directory:
+
+- **Local rules**: You can place rules files in your project directory (such as `.agents/skills/` or `AGENTS.md`) to instruct the agent on specific coding style guidelines or architectural patterns. Note that Antigravity CLI also supports backward compatibility with legacy `GEMINI.md` file; however, we recommend renaming it to `AGENTS.md`.
+- **Global configuration directory**: Antigravity CLI stores global settings and configured MCP servers in `~/.antigravity/` (e.g., `~/.antigravity/mcp_config.json`).

sites/docs/src/content/tools/antigravity.md → sites/docs/src/content/ai/antigravity.md

@@ -1,18 +1,18 @@
 ---
 title: Google Antigravity
 shortTitle: Antigravity
-description: Learn about the Antigravity agentic coding assistant.
+sidenav: ai
+description: Learn about Google Antigravity agentic coding tools.
 ---
 
 ## Introduction
 
-[Antigravity][ag] is a powerful agentic coding assistant
-and IDE for building apps, including Flutter apps.
-You can pair with Antigravity to solve your
-coding tasks, create new codebases, modify existing ones,
-and answer questions.
+Google Antigravity is a suite of agentic development tools designed for building apps, including Flutter apps. The suite includes:
 
-[ag]: https://antigravity.google/
+* **Antigravity 2.0**: The core agentic assistant experience, driven via a Terminal User Interface (TUI) or Command-Line Interface (CLI).
+* **Antigravity IDE**: The focused editor experience featuring an integrated agent panel.
+
+This page describes the Antigravity IDE. For details on using the command-line tool, see the [Antigravity CLI](/ai/antigravity-cli) page.
 
 To learn some of what Antigravity is capable of,
 watch this talk from Google I/O 2026.

sites/docs/src/content/ai/coding-assistants.md

@@ -2,19 +2,24 @@
 title: AI Coding Assistants
 sidenav: ai
 description: >
-  Learn how to use AI-powered coding assistants like Antigravity and Gemini CLI
+  Learn how to use AI-powered coding assistants like Antigravity
   to accelerate your Flutter development.
 ---
 
 AI tools are not only features in your app,
 but can also be powerful assistants in your development workflow.
 
-Tools like Antigravity and Gemini CLI can help you write code faster,
+Tools like Antigravity can help you write code faster,
 understand complex concepts, and reduce boilerplate.
 
 ## Antigravity
 
-[Antigravity](https://antigravity.google/) is an in-IDE AI agent that can read and write code, run terminal commands, and help you build complex features. Some of its capabilities include:
+[Antigravity](https://antigravity.google/) is a suite of agentic development tools that includes:
+
+* **Antigravity 2.0**: The core agentic assistant experience (TUI/CLI-driven).
+* **Antigravity IDE**: The focused editor experience featuring an integrated agent panel.
+
+Some of Antigravity's capabilities include:
 
 *   **Agentic capabilities**: Unlike chat-based assistants, Antigravity can proactively edit files and run terminal commands to complete tasks.
 *   **Complex reasoning**: It can plan and execute multi-step workflows which makes it suitable for larger refactors or feature implementations.
@@ -25,24 +30,13 @@ understand complex concepts, and reduce boilerplate.
   title="Flutter + Antigravity in 10 minutes">
 </YouTubeEmbed>
 
-## Gemini CLI
-
-The [Gemini CLI](https://geminicli.com/) is a command-line AI workflow tool. It allows you to interact with Gemini models for a variety of tasks without leaving your development environment. You can use it to:
-
-* Quickly scaffold a new Flutter widget, Dart function, or a complete app.
-* Use MCP server tools, such as the Dart and Flutter MCP server.
-* Automate tasks like committing and pushing changes to a Git repository.
-
-To get started, visit the [Gemini CLI](https://geminicli.com/) website, or try this [Gemini CLI codelab](https://codelabs.developers.google.com/gemini-cli-hands-on).
-
-## Flutter extension for Gemini CLI
-
-The [Flutter extension for Gemini CLI]({{site.github}}/gemini-cli-extensions/flutter) combines the [Dart and Flutter MCP server]({{site.dart-site}}/tools/mcp-server) with rules and commands. It uses the default set of [AI rules for Flutter and Dart](/ai/ai-rules), adds commands like `/create-app` and `/modify` to make structured changes to your app, and automatically configures the [Dart and Flutter MCP server]({{site.dart-site}}/tools/mcp-server).
+To get started with the editor experience, see the [Antigravity IDE](/ai/antigravity) page.
+To get started with the command-line tool, see the [Antigravity CLI](/ai/antigravity-cli) page.
 
-You can install it by running the following command:
+## Gemini CLI (Legacy)
 
-```bash
-gemini extensions install https://github.com/gemini-cli-extensions/flutter
-```
+The [Gemini CLI](https://geminicli.com/) is a command-line AI workflow tool.
+For individual developers, it is superseded by the new [Antigravity CLI](/ai/antigravity-cli).
+It continues to be supported for Gemini Enterprise users.
 
-To learn more, check out [Flutter extension for Gemini CLI](/ai/gemini-cli-extension).
+For more details about Gemini CLI, visit the [Gemini CLI](https://geminicli.com/) website.

sites/docs/src/content/ai/create-with-ai.md

@@ -18,13 +18,13 @@ You can integrate AI-powered features like natural language understanding
 and content generation directly into your Flutter app
 using powerful SDKs, like the Firebase SDK for Generative AI.
 
-You can also use AI tools, such as Gemini Code Assist and Gemini CLI,
+You can also use AI tools, such as Gemini Code Assist and Antigravity CLI,
 to help with code generation and scaffolding.
 
 These tools are powered by the Dart and Flutter MCP server,
 which provides AI with a rich context about your codebase.
 
-The Flutter Extension for Gemini CLI makes it easy to leverage official rules,
+The Antigravity CLI makes it easy to leverage official rules,
 the MCP server, and custom commands for building your app.
 
 Additionally, rules files help fine-tune the AI's behavior
@@ -61,14 +61,14 @@ resources:
 ## AI development tools
 
 AI isn't only a feature in your app, but can also be a powerful assistant in
-your development workflow.  Tools like [Antigravity][],
-[Gemini Code Assist][], [Gemini CLI][], [Claude Code][],
+your development workflow. Tools like [Antigravity][],
+[Gemini Code Assist][], [Antigravity CLI][], [Claude Code][],
 [Cursor][], and [Windsurf][] can help you write code faster, understand complex
 concepts, and reduce boilerplate.
 
-[Antigravity]: /ai/coding-assistants
+[Antigravity]: /ai/antigravity
 [Gemini Code Assist]: /ai/coding-assistants
-[Gemini CLI]: /ai/coding-assistants
+[Antigravity CLI]: /ai/antigravity-cli
 [Claude Code]: https://www.claude.com/product/claude-code
 [Cursor]: https://cursor.com/
 [Windsurf]: https://windsurf.com/
@@ -121,9 +121,12 @@ To get started, check out the
 
 ### Antigravity
 
-[Antigravity](https://antigravity.google/) is an in-IDE AI agent that can read and write code, run
-terminal commands, and help you build complex features. Some of its capabilities
-include:
+[Antigravity](https://antigravity.google/) is a suite of agentic development tools that includes:
+
+*   **Antigravity 2.0**: The core agentic assistant experience (TUI/CLI-driven).
+*   **Antigravity IDE**: The focused editor experience featuring an integrated agent panel.
+
+Capabilities include:
 
 *   **Agentic capabilities**: Unlike chat-based assistants, Antigravity can
     proactively edit files and run terminal commands to complete tasks.
@@ -137,7 +140,7 @@ include:
   title="Flutter + Antigravity in 10 minutes">
 </YouTubeEmbed>
 
-To learn more, check out the [AI Coding Assistants](/ai/coding-assistants) guide.
+To learn more, check out the [Antigravity IDE](/ai/antigravity) guide.
 
 ### Gemini Code Assist
 
@@ -154,40 +157,17 @@ understanding of your project's codebase and can help you with:
 
 To learn more, check out the [AI Coding Assistants](/ai/coding-assistants) guide.
 
-### Gemini CLI
+### Antigravity CLI
 
-The [Gemini CLI](https://geminicli.com/) is a command-line AI workflow tool. It allows you to interact
-with Gemini models for a variety of tasks without leaving your development
-environment. You can use it to:
+The [Antigravity CLI](/ai/antigravity-cli) is a terminal-based interface (TUI) for the
+Antigravity 2.0 agentic coding assistant (`agy`). It allows you to:
 
 * Quickly scaffold a new Flutter widget, Dart function, or a complete app.
-* Use MCP server tools, such as the Dart and Flutter MCP server
-* Automate tasks like committing and pushing changes to a Git repository
-
-To get started, visit the [Gemini CLI](https://geminicli.com/) website, or try this
-[Gemini CLI codelab][].
-
-[Gemini CLI codelab]: https://codelabs.developers.google.com/gemini-cli-hands-on
-
-#### Flutter extension for Gemini CLI
-
-The [Flutter extension for Gemini CLI][flutter-extension] combines the
-[Dart and Flutter MCP server][dart-mcp-dart-docs] with rules and commands.
-It uses the default set of [AI rules for Flutter and Dart][],
-adds commands like `/create-app` and `/modify` to make
-structured changes to your app, and automatically configures the
-[Dart and Flutter MCP server][dart-mcp-dart-docs].
-
-You can install it by running the following command:
-
-```bash
-gemini extensions install https://github.com/gemini-cli-extensions/flutter
-```
+* Use MCP server tools, such as the Dart and Flutter MCP server.
+* Automate tasks like committing and pushing changes to a Git repository.
 
-To learn more, check out
-[Flutter extension for Gemini CLI](/ai/gemini-cli-extension).
+To learn more, check out the [Antigravity CLI](/ai/antigravity-cli) guide.
 
-[flutter-extension]: {{site.github}}/gemini-cli-extensions/flutter
 [dart-mcp-dart-docs]: /ai/mcp-server
 [AI rules for Flutter and Dart]: /ai/ai-rules