# Google Antigravity CLI

Google’s terminal coding agent for code exploration, multi-file changes, custom agents and connected tools, with interactive and remote workflows.

> This is the Markdown version of the Google Antigravity CLI page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/antigravity-cli>

- **Latest version**: `1.5.14,5302690847260672`
- **Developer**: Google
- **Homepage**: <https://antigravity.google/product/antigravity-cli>
- **Categories**: [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask antigravity-cli`
- **30-day installs**: 17,498
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://storage.googleapis.com/antigravity-public/antigravity-cli/1.5.14-5302690847260672/darwin-arm/cli_mac_arm64.tar.gz>
- **SHA-256**: `b01bdd4591e13ddfcb0e049bea74ae9f83e80829adcf64aaa58f5bfb1a425a54`

SHA-256 only checks that the download is complete; it is not a security certification.

## Caveats

\`agy\`'s automatic updates are disabled so that Homebrew manages them. Use \`brew upgrade --cask antigravity-cli\` instead of \`agy update\`.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "command_wrapper": [
        "agy",
        {
          "env": {
            "AGY_CLI_DISABLE_AUTO_UPDATE": "true"
          },
          "executable": "$HOMEBREW_PREFIX/Caskroom/antigravity-cli/1.5.14,5302690847260672/antigravity"
        }
      ],
      "target": "$HOMEBREW_PREFIX/bin/agy"
    },
    "phase": "install",
    "sources": [
      "agy"
    ],
    "target": "$HOMEBREW_PREFIX/bin/agy",
    "type": "command_wrapper"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.gemini/antigravity-cli"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Antigravity CLI is Google's terminal interface for agentic software development. It suits developers who want code exploration, multi-file changes and tool-assisted tasks without leaving a terminal, including SSH and tmux workflows. It is distinct from the Antigravity desktop application and can run independently.

### Features
- Interactive conversations, code search and multi-file editing with reviewable plans and diffs.
- Tool execution with permission controls and sandbox behavior.
- Custom agents and subagents, skills, rules, hooks and plugins.
- MCP integrations for connected tools; providers may require separate credentials.
- Conversation history, resuming sessions and configurable themes and verbosity.
- Shared agent capabilities and configuration integrations with the Antigravity desktop experience.

### Installation and first use
Install `brew install --cask antigravity-cli`, then run `agy` in your project directory. This cask links the supplied antigravity binary as agy. First launch guides theme/rendering choices, workspace trust and authentication. Google's official installer is another distribution option; avoid managing the same executable with competing installers.

Standard sign-in uses a Google account and applicable service access. Authentication can be stored in the native keyring: Apple Keychain, Linux Secret Service or Windows Credential Manager. Remote SSH sessions support opening the authentication URL in another browser and returning the code. Enterprise access can require organization/project onboarding.

Optional Gemini API mode requires both `GEMINI_API_KEY` and `modelProvider: "gemini"` in `~/.gemini/antigravity-cli/settings.json`; the environment variable alone does not select that provider. API usage has its own quotas and billing. Remove the provider override before returning to normal account authentication. `/logout` clears stored session authentication but does not unset an API key supplied by your environment.

### Systems and dependencies
The Homebrew cask requires macOS12 or later and selects Apple Silicon or Intel archives. Official CLI installation documentation also covers Linux, Windows and Googlebook; these are separate installations, not products installed by the Mac cask. No numeric Windows/Linux minimum or fixed RAM requirement was confirmed in the CLI documentation retrieved; do not substitute the desktop IDE's requirements.

The cask declares no additional formula dependency or explicit cask conflict. It supplies a native CLI, not a Node.js package requiring a separate npm installation. A working terminal and network access to the chosen service are needed. Project compilers, runtimes, Git, build tools and executables used by MCP integrations depend on the tasks you run and must be available separately. The desktop application is optional.

The official Apple Silicon1.3.1 archive is54,461,807 bytes, verified from its HTTP Content-Length. Installed files, caches and conversation data add storage beyond this download. Homebrew zap includes `~/.gemini/antigravity-cli`; inspect and back up needed settings/history before removing that directory. Local cleanup does not delete a Google account.

### Accounts, costs and licensing
Downloading the CLI does not imply unlimited model usage. Account eligibility, plan entitlements, service quotas and any paid AI credits govern hosted use; Gemini API mode follows that API's separate billing and quota rules. Check the current official plan and terms for your account and region.

Google's software/service terms apply. The public repository publishes documentation, examples and release history; its existence is not evidence that the complete distributed client is MIT- or Apache-licensed. Connected services and project dependencies have their own licenses. The README describes interaction-data collection and an opt-out setting; review the applicable privacy and enterprise terms before sending project content.

### Official references
- Product: https://www.antigravity.google/product/antigravity-cli
- Installation: https://www.antigravity.google/docs/cli/install
- Documentation: https://www.antigravity.google/docs/cli/overview
- Repository and release history: https://github.com/google-antigravity/antigravity-cli
- Terms: https://www.antigravity.google/terms

## System requirements

- macOS 12 or later · Version: 1.5.14,5302690847260672 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · Checked 2026-11-21
  - <https://storage.googleapis.com/antigravity-public/antigravity-cli/1.5.14-5302690847260672/darwin-x64/cli_mac_x64.tar.gz>
  - SHA-256: `c142141141cbaa93f4e46904b76341e349f3f2b78445f877f39468dfe60dda1e`
- macOS 12 or later · Version: 1.5.14,5302690847260672 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · Checked 2026-11-21
  - <https://storage.googleapis.com/antigravity-public/antigravity-cli/1.5.14-5302690847260672/darwin-arm/cli_mac_arm64.tar.gz>
  - SHA-256: `b01bdd4591e13ddfcb0e049bea74ae9f83e80829adcf64aaa58f5bfb1a425a54`

## Uninstall

- `brew uninstall --cask antigravity-cli`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask antigravity-cli`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.gemini/antigravity-cli` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · These entries come from the Homebrew definition, checked 2026-11-21. They say what it declares, not what is on your Mac.

## Latest release notes

### 1.5.14 (2026-11-21)

Google Antigravity CLI 1.5.14 lets terminal users stream model thinking, review remote-agent plans, and see live swarm progress before files change.

**Thinking**

- /thinking streams full model thinking live and keeps finished thoughts expanded.
- It is off by default and saved as showThinking in settings.json.

**Remote**

- Plan mode lets a remote agent write a reviewable plan before edits or commands.
- Save default, accept-edits, or plan as the remote Agent Mode.

**Swarm**

- /swarm board adds a live Overview on terminals at least 28 rows tall.
- It shows the goal, task progress, blocked work, and up to six threads.

## Facts and sources

- <https://opennavo.com/apps/antigravity-cli>
- <https://opennavo.com/apps/antigravity-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/antigravity-cli.rb> · Checked 2026-11-21
- <https://formulae.brew.sh/cask/antigravity-cli>
