Getting Started with Antigravity CLI

This article covers the initial setup and configuration for the Antigravity CLI on a stock Linux...

title: Getting Started with Antigravity CLI published: true series: agy date: 2026-05-20 20:14:07 UTC tags: googleio,geminicli,antigravitycli,googleantigravity canonical_url: https://medium.com/google-cloud/getting-started-with-antigravity-cli-26c5da90951f

This article covers the initial setup and configuration for the Antigravity CLI on a stock Linux Environment.

What is Antigravity CLI?

The Google Antigravity CLI is a lightweight Terminal User Interface (TUI) that allows developers to invoke, monitor, and interact with Google Antigravity AI agents directly from the command line. It pairs with Antigravity 2.0 to offer the same core agentic capabilities — like multi-step reasoning, tool calling, and sub-agents — without the overhead of a desktop application.

More information is available here:

Google Antigravity

What Happened to Gemini CLI?

One door closes and another one opens. There was significant overlap with functionality with Gemini CLI- so that project has been sunsetted. For transition information- here are the details:

An important update: Transitioning Gemini CLI to Antigravity CLI

https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/

What about my Gemini CLI Plugins/Skills/Settings?

Detailled migration information is available here:

Google Antigravity

Download and Install agy CLI

The main download page is here:

Google Antigravity

For a terminal window/ shell install:

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

This will start the installation process:

xbill9@penguin:~$ curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: linux_amd64
⠋ Querying release repository...
✓ Latest available version: 1.0.0
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0520 12:45:41.951534 14248 installer.go:27] Running Antigravity CLI setup...
I0520 12:45:41.951720 14248 installer.go:147] Appending PATH export to profile /home/xbill9/.bashrc: export PATH="/home/xbill9/.local/bin:$PATH"
I0520 12:45:41.951931 14248 installer.go:184] Successfully updated shell profile: /home/xbill9/.bashrc
I0520 12:45:41.951995 14248 installer.go:147] Appending PATH export to profile /home/xbill9/.profile: export PATH="/home/xbill9/.local/bin:$PATH"
I0520 12:45:41.952068 14248 installer.go:184] Successfully updated shell profile: /home/xbill9/.profile

Warning: /home/xbill9/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:

  echo 'export PATH="/home/xbill9/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

✅ Antigravity CLI binary placed successfully at /home/xbill9/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.

Testing the Antigravity CLI Environment

Once you have the package installed — you can test the startup of Antigravity CLI. You will need to authenticate with a Google Project or your Google Account:

Then step through the process:

And finally the One time code:

Initial Configuration

Once you have installed and authenticated. Step through initial configuration:

Are we There Yet!?!?

If all the stars align and you do the correct sacrifices to the pagan Gods then at this point you should be able to start up the agy CLI and get down to business.

Instead of gemini the startup command is agy:

xbill@penguin:~$ agy

All Right Already! Can you actually do something with Antigravity CLI?

Fire up that terminal window and get to work:

> what can I do at Google I/O ?
▸ Thought Process
  Considering User Intent
  Depending on your developer focus, you can tailor your Google I/O experience into a specialized
  learning journey. Here is a breakdown of the core developer pathways and exactly what you can do
  in each:
  ──────
  ### 🚀 Journey 1: The AI & Agent Developer

  If you want to build intelligent, autonomous, and highly context-aware systems:

  • Master Gemini 3.5: Explore the latest APIs to leverage massive context windows, multimodal
  inputs (text, image, audio, video), and enhanced coding capabilities.
  • Develop with Antigravity 2.0: Learn how to use this new agent-first development platform to
  build autonomous, goal-oriented systems that can run multi-step reasoning workflows directly in
  production.
  • Integrate Firebase Genkit: Dive into sessions showing how to build, test, and run AI-powered
  features using TypeScript/JavaScript or Go in a developer-friendly framework.

  ### 📱 Journey 2: The Mobile & Spatial Developer

  If you build apps for phones, tablets, foldables, and wear:

  • Design for Android XR: Start building immersive, spatial experiences for upcoming smart
  glasses and headsets using your existing knowledge of Kotlin and Jetpack Compose.
  • Adopt Kotlin Multiplatform (KMP): Learn best practices for sharing business logic, networking,
  and data storage between iOS and Android.
  • Implement On-Device AI: Watch deep dives on using Gemini Nano locally on Android devices to
  handle tasks like smart replies, summarization, and translation without requiring network calls.

  ### 🌐 Journey 3: The Modern Web Developer

  If you are dedicated to building fast, beautiful, and accessible web applications:

  • Build with Built-in Browser AI: Discover how to utilize Chrome’s new built-in AI APIs
  (leveraging local on-device models) directly within your web apps.
  • Leverage Modern CSS & Web Performance: Explore upcoming browser APIs, new layout models, and
  how to track modern Core Web Vitals to deliver ultra-premium web experiences.
  • Rely on Baseline: Learn how the "Baseline" initiative makes it easy to identify which modern
  web features are universally supported across Chrome, Safari, Firefox, and Edge.

  ### ☁️ Journey 4: The Cloud & Backend Engineer

  If you manage deployment, scalability, and developer workflows:

  • Deploy with Firebase App Hosting: Try out the next-generation hosting platform that
  automatically detects, builds, and deploys server-rendered frameworks like Next.js, Angular, and
  Nuxt.
  • Scale AI Workloads on GKE: Learn how to optimize Kubernetes for high-performance AI inference
  and custom model fine-tuning.
  • Utilize Vertex AI Agent Builder: Build enterprise-grade agents grounded in private data
  sources with zero machine-learning experience required.
  ──────
  ### How to Take Action Now

  1. Bookmark your path: Go to the Google I/O Session Catalog https://io.google/2026/program/ and
  filter by your chosen pathway.
  2. Access Codelabs: Go to io.google/codelabs https://io.google to access step-by-step
  programming tutorials for all these new technologies.
  3. Engage with Google Experts: Visit the digital developer forums or official Discord channels
  to ask questions and discuss lessons with the engineers who built these products.

Get high level agy e nvironment info:

>/help
─────────────────────────────────────────────────────────────────────────────────────────────────────
Antigravity CLI general commands shortcuts (←/→ or tab to cycle)
Antigravity CLI understands your codebase, makes edits with your permission,
and executes commands — right from your terminal.

Version 1.0.0
[email protected]
Workspace: ~
Project: /home/xbill9
Conversation: 86603edc-f09c-45c1-93ba-3143c49e9035

Quick Reference
  / Type / to see available commands

You can switch between models:

      ▄▀▀▄ Antigravity CLI 1.0.0
     ▀▀▀▀▀▀ [email protected]
    ▀▀▀▀▀▀▀▀ Gemini 3.5 Flash (High)
   ▄▀▀ ▀▀▄ ~
  ▄▀▀ ▀▀▄

─────────────────────────────────────────────────────────────────────────────────────────────────────
> /model
─────────────────────────────────────────────────────────────────────────────────────────────────────
Switch Model

> Gemini 3.5 Flash (High) (current)
  Gemini 3.5 Flash (Medium)
  Gemini 3.1 Pro (High)
  Gemini 3.1 Pro (Low)
  Claude Sonnet 4.6 (Thinking)
  Claude Opus 4.6 (Thinking)
  GPT-OSS 120B (Medium)

Get Context info:

>/context
─────────────────────────────────────────────────────────────────────────────────────────────────────
└ Context Usage
◉ ◉ ◉ ◉ ◉ ◉ ◉ ◉ □ □ □ □ □ □ □ □ □ □ □ □ Gemini 3.5 Flash (High) · 29.9k/1.0M tokens
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ (2.9%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ Token usage by category
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ ◉ User messages: 14 tokens (0.0%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ ◉ Agent responses: 6.2k tokens (0.6%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ ◉ Tool calls: 153 tokens (0.0%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ ⛁ System prompt: 7.5k tokens (0.7%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ ⛁ System tools: 15.4k tokens (1.5%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ ⛁ Subagents: 662 tokens (0.1%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ Free space: 1.0M (97.1%)
□ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ □ ⊠ Checkpoint buffer: 516 tokens (not counted in
                                            usage)

Checkpoints (1) · /rewind
└ Checkpoint 1 (active, in context): steps 0–4

Check your quota:

>/usage
─────────────────────────────────────────────────────────────────────────────────────────────────────
└ Model Quota

  Gemini 3.1 Pro (Low)
  ███████████ ███████████ ███████████ ███████████ ███████████ 100%
  Quota available

  Claude Sonnet 4.6 (Thinking)
  ███████████ ███████████ ███████████ ███████████ ███████████ 100%
  Quota available

  Claude Opus 4.6 (Thinking)
  ███████████ ███████████ ███████████ ███████████ ███████████ 100%
  Quota available

  GPT-OSS 120B (Medium)
  ███████████ ███████████ ███████████ ███████████ ███████████ 100%
  Quota available

Summary

Antigravity CLI was introduced as a compliment to the existing GUI based IDE versions.Some transition information was provided for Gemini CLI users. Antigravity CLI was then installed from the official Google sources. A sample query was tested and some common slash commands were highlighted.

Good-bye Gemini CLI- it was nice to know you! Hello Antigravity CLI- I am sure we can be friends! When one door closes- another one opens.