Gemini CLI or Antigravity CLI: Which Should You Use?
If you're on a free account or Google AI Pro or Ultra, use Antigravity CLI, run with agy. Gemini CLI stopped serving those accounts on June 18, 2026. Stay on Gemini CLI only if your organization has a Gemini Code Assist Standard or Enterprise license, or you have a paid API or Vertex key.
Start in a project folder: cd [your-project] agy Then give it a bounded first job: Read GEMINI.md and the code in [folder]. Without changing anything, tell me how [feature] works, list the files involved, and propose the smallest change that would [goal]. Wait for my OK before you edit. Moving from Gemini CLI: agy plugin import gemini Then move `.gemini/skills/` to `.agents/skills/`.
- May 19, 2026Move announced
- Jun 18, 2026Gemini CLI cutoffstops serving Google AI Pro and Ultra
- Oct 13, 2026Antigravity in the macOS app
- Free accounts
- Google AI Pro and Ultra
- Gemini 4 Argon and newer
- Multi-agent coding
- Code Assist Standard or Enterprise
- Code Assist for GitHub on Google Cloud
- Legacy paid API and Vertex keys
- Not tuned for Gemini 4
Try it now
- 1Get Antigravity CLI from antigravity.google/download. Google's product page links there and doesn't show an install command.
- 2In a terminal, go to your project folder and run
agy. First launch walks you through color scheme, rendering mode and workspace trust. - 3If you used Gemini CLI before, follow the checklist it shows of profiles to migrate, then run
agy plugin import gemini. - 4Paste the first job above. You'll know it's working when it names your real files and waits for your OK before editing.
Use it when
When you want an agent to edit files and run commands in a real project, rather than chat about code you've uploaded. It's also worth checking when an old tutorial tells you to sign in to gemini with a personal Google account, because that route has closed.
Skip it when
If you only want a model's answer inside a script, neither agent is the right fit, so look at gemini-api. And if you want a quick answer about code you've pasted, the Gemini app is simpler. Don't move a working company setup on Code Assist either, since Google says that access is unchanged.
Why it works
Google announced the move on May 19, 2026. Its README now says "No free tier" for Gemini CLI, and that it isn't tuned for the Gemini 4 series, so its scores for those models would be unrepresentative. Antigravity has a $0 plan for individuals with basic weekly rate limits, and Pro and Ultra add higher limits. A third tool, the Gemini API CLI (gemini-api), is stateless and made for scripts and CI. Google says it isn't a coding agent. Antigravity is also built into the Gemini macOS app since October 13, 2026.
Example
Say you're a freelancer who used gemini with a Google AI Pro account, and your scripts have stopped getting responses. Install agy, run it in the project, and accept the migration checklist. Your GEMINI.md needs no changes, since the migration docs say the agent still reads it. Your extensions need converting with the plugin import command. If a script only called gemini -p for a one-line summary, consider gemini-api for that script instead.
Going further
The migration page lists details the announcement leaves out. MCP servers move to ~/.gemini/config/mcp_config.json globally, or .agents/mcp_config.json for a workspace. Remote servers need url or httpUrl replaced with serverUrl. Old commands become skills. Google said there "won't be 1:1 feature parity" at launch, and the migration page notes that some custom terminal themes may not carry over, so test a real workflow before you depend on it.
Common mistakes
- Following a pre-2026 tutorial that promises 1,000 free requests a day in Gemini CLI. Parts of Google's own docs still read that way, but the README and banner say otherwise.
- Leaving skills in
.gemini/skills/after moving. The docs say to move them to.agents/skills/, so the agent recognizes them. - Benchmarking Gemini 4 through Gemini CLI. Google warns the scores are unrepresentative.
- Assuming Google AI Pro pays for API use, because Antigravity is included. They're billed separately.
Sources
- Gemini CLI README
- Gemini CLI home page
- Transitioning Gemini CLI to Antigravity CLI, Google for Developers
- Antigravity CLI
- Antigravity pricing
- Gemini CLI migration, Antigravity docs
- Gemini Apps release notes
Checked 6 November 2026. Products change often, so confirm details with the vendor.