> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Antigravity (experimental)

> Use Google's Antigravity CLI in the AI dock: install, sign in, known limits and fixes.

> [!WARNING]
>
> Antigravity support is experimental. It may change or stop working between CoClip and Antigravity releases. For your main projects, prefer [Claude Code](/docs/ai-agents/claude-code.md), [Codex](/docs/ai-agents/codex.md) or [OpenCode](/docs/ai-agents/opencode.md).

The Antigravity CLI (`agy`) is Google's command-line agent. In CoClip it runs in an **Antigravity** tab of the [AI dock](/docs/ai-agents/ai-dock.md), with the CoClip tools, skills and agent roles.

## Install and sign in

CoClip needs Antigravity CLI **1.4.7** or newer. CoClip never installs or updates it. The install commands come from Google; check the [official Antigravity site](https://antigravity.google) for the current steps. There is no npm package.

**1. Install the Antigravity CLI**

> [tab] Windows
>
> Open PowerShell and run:
>
> ```powershell theme={null}
> irm https://antigravity.google/cli/install.ps1 | iex
> ```

> [tab] macOS
>
> Open Terminal and run:
>
> ```bash theme={null}
> curl -fsSL https://antigravity.google/cli/install.sh | bash
> ```

**2. Sign in with Google once**

Run `agy` and sign in with your Google account.

**3. Open an Antigravity tab**

In CoClip, click **+** in the AI dock and pick **Antigravity**.

Antigravity has no setup choice in **Settings**. Every session uses only CoClip's tools, skills and agents.

## Known limits

* **Keep the default ask-first mode.** In Antigravity's default mode, every command asks you first. Do not switch to Auto or sandbox mode: there, commands can read your real home folders, such as your SSH keys and settings.
* **Its own home folder.** CoClip runs Antigravity in a separate Antigravity home folder that all CoClip Antigravity sessions share. Your own Antigravity settings, MCP servers, skills and agents are never loaded or changed. Sign-in and first-run screens happen once there.
* **Tools that read your home folder start fresh.** Commands Antigravity runs keep your git name and email, but tools such as `gh`, npm config and `gcloud` start without your own settings.
* **Telemetry** follows your Google account setting.
* **Project files can turn it off.** Some agent files in the project folder (or its parent folders), such as hooks, plugins or MCP files, or agents and skills named like CoClip's, would let Antigravity run code from the project. The tab then says **Antigravity is turned off for this project** and lists those files by name. Remove or rename them to use Antigravity there. Your other AI sessions keep working.
* **Newer major versions are untested.** Antigravity 2.x and later still starts, with a notice as the first line of the tab.

## Messages and fixes

| What you see | Fix |
| - | - |
| **Antigravity CLI is not installed on this PC** (or Mac) | Run the install command above, run `agy` once to sign in with Google, then click **Open Antigravity again**. The installer puts `agy` in a folder CoClip already checks. |
| **Antigravity CLI … is too old for CoClip** | Run the install command again. It always installs the latest release. |
| **CoClip could not read the Antigravity CLI version** | Run `agy --version` in a terminal. If it fails, run the install command again. |
| **CoClip has not been tested with Antigravity …** (first line of the tab) | The session still runs. If something fails, use another agent until CoClip supports that version. |
| **Antigravity is turned off for this project** | Remove or rename the listed files, then open the tab again. |
| **Antigravity support is incomplete in this build of CoClip** | Reinstall CoClip. See [Install](/docs/get-started/install.md). |
| Antigravity is still not found after installing | Restart CoClip. |

## Related pages

* [Use Antigravity outside the editor](/docs/ai-agents/outside-the-editor.md#antigravity)
* [AI log and undo](/docs/ai-agents/ai-log-and-undo.md)
* [Troubleshooting](/docs/reference/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.