Antigravity CLI
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.
The Antigravity CLI replaces the legacy Gemini CLI.
Installation
#Install the Antigravity CLI on your machine by running the appropriate command for your platform:
curl -fsSL https://antigravity.google/install.sh | bash
irm https://antigravity.google/install.ps1 | iex
winget install Google.AntigravityCLI
After installation, verify that the tool is available on your path by running:
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:
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/orAGENTS.md) to instruct the agent on specific coding style guidelines or architectural patterns. Note that Antigravity CLI also supports backward compatibility with the legacyGEMINI.mdfile; however, we recommend renaming it toAGENTS.md. -
Global configuration: Antigravity CLI stores global settings
and configured MCP servers in
~/.antigravity/(e.g.,~/.antigravity/mcp_config.json).
Unless stated otherwise, the documentation on this site reflects Flutter 3.44.0. Page last updated on 2026-06-09. View source or report an issue.