Instalar Antigravity CLI: guía básica

Objetivo

Al terminar vas a tener Antigravity CLI instalado, con sesión iniciada con tu cuenta de Google, y una primera tarea de agente corriendo sobre un proyecto real.

Antigravity CLI es la interfaz de terminal de la plataforma Antigravity de Google. El binario se llama agy. Corre los mismos agentes que usarías en el editor de Antigravity, pero desde la terminal: tareas en lenguaje natural, subagentes en paralelo, servidores MCP y slash commands, sin cambiar de contexto.

Prerrequisitos

macOS, Linux o Windows (PowerShell o CMD).
Una terminal con permisos para instalar binarios en tu PATH.
Una cuenta de Google con acceso a Antigravity.
Un proyecto local sobre el que trabajar.

Esta guía cubre la versión v1.1.22 de Antigravity CLI.

Pasos

1. Instalar el binario

Elegí el método según tu sistema.

macOS / Linux:

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

Windows (PowerShell):

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

Windows (CMD):

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

El instalador deja el binario agy en:

macOS / Linux: ~/.local/bin/agy
Windows: C:\Users\<usuario>\AppData\Local\agy\bin

Si agy no se encuentra después de instalar, agregá ese directorio a tu PATH y abrí una terminal nueva.

2. Verificar la instalación

agy --version

Verificación esperada: imprime la versión instalada (por ejemplo 1.1.22). Si la terminal responde "command not found", abrí una sesión nueva para que tome el PATH actualizado.

3. Primer arranque e inicio de sesión

Andá a un proyecto y arrancá la CLI:

cd ruta/a/tu/proyecto
agy

El primer arranque te guía por:

Esquema de color — Solarized Dark, Dark, Solarized Light o los colores propios de tu terminal.
Modo de renderizado — Alt-Screen (TUI a pantalla completa) o Inline (deja la salida en el historial de la terminal).
Confianza del workspace — confirmá que confíás en este repositorio. El agente indexa los archivos.

La autenticación va por tu cuenta de Google: se abre una ventana del navegador para iniciar sesión. En una máquina remota, copiá la URL que aparece en la terminal y abrila localmente.

4. Correr tu primera tarea

Dentro de la sesión, describí lo que querés en lenguaje natural:

Escribí un script simple en Python que traiga el texto de una página web

El agente planifica, edita archivos y ejecuta comandos, y se detiene a pedir tu aprobación en cualquier cosa que no pueda deshacer.

5. Explorar los comandos integrados

/agents        # lanzar y gestionar subagentes en paralelo
/config        # ajustes de terminal y comportamiento
/keybindings   # ver y personalizar atajos

Resultado esperado

agy --version imprime la versión.
agy abre la TUI sobre tu proyecto después del setup inicial.
Tenés sesión iniciada con tu cuenta de Google y el workspace está confiado e indexado.
Una primera tarea en lenguaje natural produce cambios reales en archivos.

Troubleshooting

Problemas comunes

agy: command not found después de instalar: el instalador agregó el binario al PATH pero tu shell actual no lo tomó. Abrí una terminal nueva, o agregá el directorio de instalación (~/.local/bin en macOS/Linux) al PATH a mano.
El navegador no se abre para iniciar sesión: copiá la URL de autenticación que se imprime en la terminal y abrila vos en un navegador. Útil por SSH.
El agente no toca los archivos: probablemente salteaste la confianza del workspace o marcaste el repo como no confiable. Reiniciá agy en el proyecto y confirmá la confianza.
La TUI borra tu scrollback: elegiste el renderizado Alt-Screen. Volvé a correr el setup o usá /config para cambiar a modo Inline.

Siguiente paso

Configurá la CLI por proyecto con /config, conectá servidores MCP para herramientas y datos externos, y usá /agents para repartir una tarea grande entre subagentes en paralelo.