How to Use Antigravity CLI (agy): Install, Commands, and Multiple Sessions

By CodeAgentSwarm · Updated October 31, 2026

If you used Gemini CLI and went looking for it recently, you found it gone. On June 18, 2026 Google stopped serving Gemini CLI for free and Google AI Pro and Ultra accounts and moved those users to Antigravity CLI, the agy command. This guide is the practical walkthrough: what Antigravity CLI actually is, how to install it on macOS, Linux, and Windows, the commands you will use every day, and how it picks up your old Gemini config on the first run. Antigravity CLI is a single compiled binary with no Node or Python runtime to manage, and it offers Gemini, Claude and open-weight models in the same terminal instead of Gemini alone. It is also multi-agent by default, so a single agy session dispatches and coordinates its own sub-agents inside a task rather than running as one linear chat. By the end you will be comfortable using Antigravity CLI on its own, and you will know how to run several independent agy sessions in parallel when one terminal stops being enough.

What is Antigravity CLI?

Antigravity CLI is Google's official command-line coding agent, invoked with the agy command. It is the direct successor to Gemini CLI. Google announced the transition on the Google Developers Blog, and on June 18, 2026 Gemini CLI stopped serving free and Google AI Pro and Ultra accounts. Gemini CLI is still maintained for enterprise Gemini Code Assist customers on Google Cloud, but for individual developers agy is the tool now.

Three things make Antigravity CLI different from the tool it replaces, and they are worth understanding before you install it.

One binary, no runtime

Antigravity CLI ships as a single compiled binary. There is no Node.js or Python to install first, no version mismatch to chase, no global npm package to keep updated. You drop in one executable and run it. That alone removes most of the setup pain people had with the old CLI.

Several model families in one terminal

Where Gemini CLI gave you Gemini, Antigravity CLI puts Gemini, Claude and open-weight models behind the same command. Which ones you get depends on your plan. As of October 2026 the official model list offers Gemini 3.8 Flash on every plan, adds Gemini 4 Argon, Claude Sonnet 5.5 and Claude Opus 5.5 on paid Google AI plans, and keeps Claude Sonnet 4.6, Claude Opus 4.6 and GPT-OSS 120B on the free tier until Google removes them on November 2, 2026. You switch with /model or --model, and agy models lists what your account can use. Having more models in one CLI is the headline change, and it means you rarely have to leave agy to reach for a different model.

Multi-agent by default

A single agy session is not a single linear chat. By default it dispatches and coordinates sub-agents within a task, breaking the work into pieces and managing them itself. You give it a goal and it organizes the steps under the hood. That is a real shift from the one-thread mental model most CLIs use.

Multi-agent inside one task is different from running several sessions at once. agy coordinates its own sub-agents for the job in front of it. When you want to work on several independent projects or tasks at the same time, you run several independent agy sessions in parallel, which is exactly what an AI CLI agent swarm is about. More on that in the last section.

How to install Antigravity CLI

agy install: the short version

On macOS and Linux, run curl -fsSL https://antigravity.google/cli/install.sh | bash. On Windows, run irm https://antigravity.google/cli/install.ps1 | iex in PowerShell, which installs the binary under %LOCALAPPDATA%. Then open a new terminal and run agy. That is the whole agy install: there is no Node or Python runtime to set up first.

Installing Antigravity CLI is a one-line job on every platform. Because it is a single binary, there is no runtime to set up first.

macOS and Linux

Run the official install script from your terminal. It downloads the binary, puts it on your PATH, and you are done.

bash
curl -fsSL https://antigravity.google/cli/install.sh | bash

When it finishes, open a new terminal and run agy to confirm it is on your PATH. The first launch handles sign-in and, if you had Gemini CLI before, offers to bring your old config across (covered in the next section).

Windows

On Windows, use the PowerShell installer. It pulls the binary and installs it under %LOCALAPPDATA%, no admin rights or extra runtime required.

powershell
irm https://antigravity.google/cli/install.ps1 | iex

Open a fresh PowerShell or terminal window afterward so the updated PATH is picked up, then run agy to start.

No Node, no Python, no package manager. If you have scripts or CI that still install Gemini CLI through npm and sign in with a personal Google account, that path no longer works. Swap it for the install script above and call agy instead of gemini.

First launch and migrating from Gemini CLI

The first time you run agy, it signs you in with your Google account and then checks for an existing Gemini CLI setup. Antigravity reuses the same ~/.gemini home directory, so it knows exactly where to look.

If ~/.gemini exists, agy shows a checklist of the Gemini CLI extensions and global settings it can convert. You can run the same conversion later with agy plugin import gemini, which moves your MCP servers into ~/.gemini/config/mcp_config.json. Custom terminal themes may not carry over, and workspace skills in .gemini/skills/ have to be moved to .agents/skills/ by hand, as the official migration guide explains.

Where the config lives

  • ~/.gemini - the shared home directory Antigravity reuses, so your existing data and history are right where you left them
  • ~/.gemini/GEMINI.md - your global instructions file, read on every session, the same way the old CLI used it
  • ~/.gemini/antigravity-cli/settings.json - the Antigravity CLI settings file, where the agy-specific configuration is stored

Because GEMINI.md is still the global instructions file, any project conventions or persona you wrote for Gemini CLI keep working under agy with zero changes. Drop your rules there and every session reads them.

If you never used Gemini CLI, there is nothing to migrate. agy just signs you in and starts fresh, and you can add a ~/.gemini/GEMINI.md later whenever you want global instructions.

Essential Antigravity CLI commands

You can do almost everything with a handful of commands and flags. Here are the ones worth knowing from day one.

bash
# Start a new session in the current project
agy

# Continue your last conversation
agy -c

# Resume a specific conversation by id
agy --conversation <id>

# Turbo mode: auto-approve actions, no confirmation prompts
agy --dangerously-skip-permissions

Starting and resuming sessions

Plain agy starts a new session in whatever directory you are in. agy -c picks up the most recent conversation in that directory right where it ended, which is the one you will reach for most. When you have several conversations and want a specific older one, agy --conversation <id> resumes it by id.

Turbo mode (skip permissions)

The --dangerously-skip-permissions flag is the turbo, auto-approve mode. agy stops asking for confirmation and just runs. It is the fastest way to work, and it is exactly as risky as the name says, so use it on trusted tasks where you are happy for the agent to act without a checkpoint on every step.

Choosing a model

You do not have to pass a model flag: agy starts with a default, and whatever you pick persists for the rest of the conversation. To change it, type /model inside a session or start with agy --model <id>. Run agy models to see the ids your plan includes, since the list differs between the free tier and paid Google AI plans.

MCP servers

Antigravity CLI supports MCP servers, and if you imported your Gemini CLI config they are already wired in. Global servers live in ~/.gemini/config/mcp_config.json and per-project ones in .agents/mcp_config.json. Add one with agy mcp add or edit the JSON directly, then type /mcp inside a session to check its status.

json
// ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my/mcp-server"]
    }
  }
}

Once a server is in that file, agy connects to it on the next session and its tools become available inside the agent. The mcpServers format is the one Gemini CLI used. If you move a remote server by hand, rename its url or httpUrl key to serverUrl.

Running multiple Antigravity CLI sessions in parallel

One agy session coordinates sub-agents for the task in front of it. But often you want to push on several fronts at once: a feature in one project, a bug fix in another, docs in a third. Each of those is its own agy session, its own process, with its own conversation and context. Running them at the same time is where a visual workspace earns its place.

CodeAgentSwarm in List mode with agents, statuses, current activities and project shortcuts
CodeAgentSwarm List view: each session shows its agent, status and current activity. Sample tasks shown.

CodeAgentSwarm is a desktop app for macOS, Windows and Linux built for exactly this. It gives you multiple terminals in one window, and in the SELECT AI AGENT picker you choose the agent per terminal: claude-code, codex cli, or antigravity. Set several terminals to antigravity and you have a control room for parallel agy sessions, all in one place.

CodeAgentSwarm is not a model provider. Each agy session keeps using your own Google sign-in and your own Antigravity install. The app just gives the sessions a home and adds the things that matter once you are running more than one:

  • Per-terminal dynamic titles, so instead of identical "agy" tabs you see what each session is actually doing right now
  • Desktop notifications the moment a session finishes or stops to ask you something, so you stop babysitting tabs (more in the notifications guide)
  • Searchable conversation history across every session, so you can trace what any agy session did and resume it later (see the conversation history guide)
  • A kanban board your sessions update themselves over MCP, keeping the big picture in one view
  • Turbo Mode with granular permissions, so a session moves fast on safe operations while risky ones stay gated (see the Turbo Mode guide)
  • Per-terminal live file diffs, so overlapping edits between sessions never surprise you (see the real-time changes guide)

For the step-by-step on running several agy sessions at once, see running multiple Antigravity CLI sessions. If you are still deciding whether to move off the old tool, Antigravity CLI vs Gemini CLI lays out exactly what changed. And because antigravity sits next to Claude Code and Codex CLI in the same picker, the same workspace also runs multiple Claude Code sessions and multiple Codex sessions when a task fits one of them better.

Start with one agy session to get a feel for the multi-agent behavior. When you find yourself wanting a second and a third going at once, open them as separate terminals in CodeAgentSwarm and let the dynamic titles and notifications keep you oriented. The Antigravity agent swarm guide covers that workflow end to end: worktree isolation, why approval mode does not scale past one agent, and how to keep every session supervisable.

FAQ

What is Antigravity CLI (agy)?

Antigravity CLI is Google's official command-line coding agent, run with the agy command. It is the direct successor to Gemini CLI, which stopped serving free and Google AI Pro and Ultra accounts in June 2026. agy ships as a single compiled binary, offers Gemini, Claude and open-weight models in one terminal, and is multi-agent by default, meaning one session coordinates its own sub-agents within a task.

How do I install Antigravity CLI?

On macOS and Linux, run curl -fsSL https://antigravity.google/cli/install.sh | bash. On Windows, run the PowerShell installer with irm https://antigravity.google/cli/install.ps1 | iex, which installs it under %LOCALAPPDATA%. It is a single binary, so there is no Node or Python runtime to set up first. Open a new terminal afterward and run agy to start.

How do I install agy?

The agy install is one line. On macOS and Linux, run curl -fsSL https://antigravity.google/cli/install.sh | bash. On Windows, run irm https://antigravity.google/cli/install.ps1 | iex in PowerShell, which puts the binary under %LOCALAPPDATA% with no admin rights needed. Open a new terminal so the PATH is picked up, then run agy.

Is agy the same thing as Antigravity CLI?

Yes. agy is the command you type; Antigravity CLI is the tool it runs. Google ships Antigravity CLI as a single binary called agy, so "agy install" and "install Antigravity CLI" mean the same thing.

Is Antigravity CLI free?

Yes. You sign in with a Google account and get a free weekly quota, while Google AI Pro and Ultra add higher limits that refresh every five hours. CodeAgentSwarm does not change that, since it is not a model provider. Each agy session keeps using your own Google sign-in, whether you run one session or several in parallel.

Does Antigravity CLI replace Gemini CLI?

For individual developers, yes. On June 18, 2026 Gemini CLI stopped serving free and Google AI Pro and Ultra accounts, and Google moved those users to Antigravity CLI, as announced on the Google Developers Blog. Gemini CLI remains for enterprise Gemini Code Assist customers. agy reuses the same ~/.gemini home directory and reads global instructions from ~/.gemini/GEMINI.md, so your old config and conventions carry over. On first launch it offers to convert your Gemini CLI extensions and settings, including MCP servers.

What models does Antigravity CLI support?

It depends on your plan. As of October 2026 Google lists Gemini 3.8 Flash on every plan, Gemini 4 Argon and Claude Sonnet 5.5 and Opus 5.5 on paid Google AI plans, and Claude Sonnet 4.6, Claude Opus 4.6 and GPT-OSS 120B on the free tier until November 2, 2026. Switch with /model or --model, and run agy models to see yours.

How do I run multiple Antigravity CLI sessions at once?

Each agy session is an independent process, so you can open several at the same time, one per project or task. The cleanest way is CodeAgentSwarm, a desktop app where you set each terminal to antigravity in the SELECT AI AGENT picker and get dynamic titles, desktop notifications, and searchable history across all of them in one workspace.

Does Antigravity CLI work on Windows?

Yes. Windows is supported through a PowerShell installer that places the binary under %LOCALAPPDATA% with no admin rights or extra runtime needed. CodeAgentSwarm also runs on Windows, so you can run multiple agy sessions in parallel there in the same visual workspace.