Cómo instalar Google Antigravity: escritorio y CLI paso a paso

Instalar Google Antigravity toma menos de diez minutos. Tienes dos opciones: la aplicación de escritorio (Antigravity 2.0) o la CLI de terminal (agy). Esta guía cubre los dos caminos, paso a paso, sin asumir conocimientos previos.

Si aún no sabes qué es Antigravity ni para qué sirve, empieza por nuestra guía general sobre Google Antigravity. Aquí vamos directo a la instalación.

Opción A: Instalar Antigravity 2.0 (aplicación de escritorio)

Requisitos

• macOS: versión 12 (Monterey) o superior. Apple Silicon (M1/M2/M3). X86 no está soportado.
• Windows: Windows 10 de 64 bits o superior.
• Linux: glibc ≥ 2.28, glibcxx ≥ 3.4.25 (Ubuntu 20, Debian 10, Fedora 36, RHEL 8 en adelante).
• Cuenta Google: necesitas una cuenta personal de Google (@gmail.com). Las cuentas de Workspace pueden tener problemas de autenticación en algunos casos.

Paso 1: Descargar

Ve a antigravity.google/download y descarga el instalador para tu sistema operativo.

Paso 2: Instalar

Ejecuta el instalador. Si ves una notificación preguntando "Keep Both" o "Replace", selecciona Replace. Durante la instalación se te puede ofrecer instalar también el IDE integrado — puedes hacerlo ahora o después.

Paso 3: Iniciar sesión

Abre Antigravity 2.0. La primera vez te pedirá que inicies sesión con tu cuenta de Google. El navegador se abre automáticamente, autorizas el acceso y vuelves a la app ya autenticado.

Paso 4: Crear tu primer Proyecto

Un Proyecto define qué carpetas puede ver y editar el agente. Para crear uno:

• Haz clic en el ícono de carpeta con "+" en la barra lateral izquierda.
• Selecciona "New Project".
• Haz clic en "Add Folder" para asociar una o más carpetas o repositorios Git.
• Haz clic en "Create".

Paso 5: Lanzar tu primer agente

Con el proyecto creado, escribe tu instrucción en el campo de chat (por ejemplo: "Explícame qué hace este proyecto") y presiona Enter. El agente elige entre modo Local o New Worktree — para empezar, Local está bien.

Opción B: Instalar Antigravity CLI (agy)

La CLI es la opción ligera: mismas capacidades de agente, desde tu terminal, sin instalar una app de escritorio.

macOS y Linux

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

Esto instala el binario agy en ~/.local/bin/agy. Si después de instalar el terminal dice "command not found", agrega la ruta a tu PATH:

export PATH="~/.local/bin:$PATH"

Pega esa línea en tu ~/.zshrc o ~/.bashrc y ejecuta source ~/.zshrc para aplicar el cambio.

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

Primer uso de la CLI

Navega a tu proyecto con cd mi-proyecto y ejecuta:

agy

La primera vez te hace una configuración inicial rápida (tema de color, modo de renderizado, confianza en el repositorio). Luego entra en modo interactivo donde puedes dar instrucciones al agente.

Autenticación en SSH (sin navegador)

Si estás en un servidor remoto por SSH y no tienes navegador disponible:

• Ejecuta agy en la sesión SSH.
• La CLI detecta el entorno y muestra una URL de autorización en pantalla.
• Copia esa URL, ábrela en un navegador en tu máquina local e inicia sesión.
• El navegador muestra un código alfanumérico. Cópialo, vuelve a la terminal SSH y pégalo cuando te lo pida.

Comandos básicos de la CLI para empezar

• agy — Modo interactivo (TUI completa).
• agy -p "tu instrucción" — Modo de un solo comando sin abrir la TUI.
• agy --continue — Retoma la última conversación de ese directorio.
• /help — Dentro de la TUI, muestra todos los comandos disponibles.
• /config — Abre el panel de configuración.
• Esc — Interrumpe cualquier acción del agente sin cerrar la sesión.
• Ctrl+D — Cierra la TUI y vuelve a tu shell normal.

Configurar el archivo GEMINI.md (equivalente al CLAUDE.md)

Crea un archivo GEMINI.md o AGENTS.md en la raíz de tu proyecto. El agente lo lee automáticamente al iniciar cada sesión. Úsalo para:

• Convenciones de nomenclatura y estilo del proyecto
• Tecnologías y versiones que se usan
• Qué archivos o carpetas no debe tocar el agente
• Comandos útiles de build, test o deploy

En resumen

Antigravity 2.0 es para quienes prefieren una app visual con gestión de proyectos y artefactos. La CLI es para quienes viven en la terminal o trabajan por SSH. Los dos usan el mismo motor; elige según tu flujo de trabajo.

Una vez instalado, el siguiente paso es entender cómo funciona el sistema de permisos y las capacidades avanzadas. Lee cómo extender Antigravity con Skills y MCP para sacarle el máximo provecho desde el día uno.