Cómo usar Antigravity CLI (agy): instalación, comandos y varias sesiones

¿Qué es Antigravity CLI?

Antigravity CLI es el agente de programación oficial de línea de comandos de Google, que se invoca con el comando agy. Es el sucesor directo de Gemini CLI. Google anunció la transición en el Google Developers Blog, retiró Gemini CLI el 18 de junio de 2026 y a partir de ahí mandó a todo el mundo a Antigravity. Si tienes por ahí una instalación antigua de gemini, está al final de su vida. Ahora lo que usas es agy.

Hay tres cosas que diferencian a Antigravity CLI de la herramienta que reemplaza, y vale la pena entenderlas antes de instalarlo.

Un binario, sin runtime

Antigravity CLI viene como un único binario compilado. No hay que instalar antes Node.js ni Python, no hay desajustes de versión que perseguir, no hay paquete global de npm que mantener actualizado. Sueltas un ejecutable y lo lanzas. Solo eso ya quita casi todo el dolor de instalación que la gente tenía con el CLI antiguo.

Ocho modelos en un terminal

Donde Gemini CLI te daba Gemini, Antigravity CLI pone ocho modelos detrás del mismo comando: la familia Gemini 3.x, Claude Sonnet 4.6, Claude Opus 4.6 y GPT-OSS 120B. Arranca por defecto con Gemini 3.5 Flash y selecciona solo el modelo adecuado para el trabajo, así que no hay ningún flag --model que memorizar. Tener más modelos en un solo CLI es el cambio estrella, y significa que casi nunca tienes que salir de agy para ir a por otro modelo.

Multiagente por defecto

Una sola sesión de agy no es un chat lineal. Por defecto reparte y coordina sub-agentes dentro de una tarea, divide el trabajo en piezas y las gestiona él mismo. Le das un objetivo y organiza los pasos por debajo. Eso es un cambio real respecto al modelo mental de un solo hilo que usan la mayoría de CLIs.

Cómo instalar Antigravity CLI

Instalar Antigravity CLI es cosa de una línea en cualquier plataforma. Como es un único binario, no hay ningún runtime que montar antes.

macOS y Linux

Ejecuta el script oficial de instalación desde tu terminal. Descarga el binario, lo deja en tu PATH y listo.

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

Cuando termine, abre un terminal nuevo y ejecuta agy para confirmar que está en tu PATH. El primer arranque se encarga del inicio de sesión y, si antes tenías Gemini CLI, te ofrece traer tu configuración antigua (lo vemos en la siguiente sección).

Windows

En Windows, usa el instalador de PowerShell. Descarga el binario y lo instala en %LOCALAPPDATA%, sin permisos de administrador ni runtime extra.

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

Después abre una ventana nueva de PowerShell o de terminal para que coja el PATH actualizado, y ejecuta agy para empezar.

Primer arranque y migración desde Gemini CLI

La primera vez que ejecutas agy, inicia sesión con tu cuenta de Google y luego busca una configuración existente de Gemini CLI. Antigravity reutiliza el mismo directorio home ~/.gemini, así que sabe exactamente dónde mirar.

Si ~/.gemini existe, agy te ofrece importar tu configuración antigua automáticamente. Eso incluye tus servidores MCP, tus comandos permitidos sin confirmación, tus atajos de teclado y tu tema. Acepta el aviso y tu setup de siempre pasa sin que tengas que volver a meter nada.

Dónde vive la configuración

• ~/.gemini - el directorio home compartido que Antigravity reutiliza, así que tus datos e historial siguen justo donde los dejaste
• ~/.gemini/GEMINI.md - tu archivo de instrucciones globales, leído en cada sesión, igual que lo usaba el CLI antiguo
• ~/.gemini/antigravity-cli/settings.json - el archivo de ajustes de Antigravity CLI, donde se guarda la configuración propia de agy

Como GEMINI.md sigue siendo el archivo de instrucciones globales, cualquier convención de proyecto o persona que escribieras para Gemini CLI sigue funcionando bajo agy sin tocar nada. Deja ahí tus reglas y cada sesión las lee.

Comandos esenciales de Antigravity CLI

Puedes hacer casi todo con un puñado de comandos y flags. Estos son los que vale la pena conocer desde el primer día.

# Iniciar una sesión nueva en el proyecto actual
agy

# Continuar tu última conversación
agy -c

# Retomar una conversación concreta por id
agy --conversation <id>

# Modo turbo: auto-aprueba acciones, sin avisos de confirmación
agy --dangerously-skip-permissions

Iniciar y retomar sesiones

agy a secas inicia una sesión nueva en el directorio en el que estés. agy -c retoma tu conversación más reciente justo donde la dejaste, que es la que más vas a usar. Cuando tienes varias conversaciones y quieres una concreta más antigua, agy --conversation <id> la retoma por id.

Modo turbo (saltar permisos)

El flag --dangerously-skip-permissions es el modo turbo de auto-aprobación. agy deja de pedir confirmación y simplemente ejecuta. Es la forma más rápida de trabajar, y es exactamente tan arriesgada como dice el nombre, así que úsalo en tareas de confianza donde te parezca bien que el agente actúe sin un punto de control en cada paso.

La selección de modelo es automática

No pasas ningún flag de modelo. agy arranca por defecto con Gemini 3.5 Flash y selecciona solo entre sus ocho modelos según la tarea. Eso mantiene el comando corto y hace que no tengas que decidir entre Gemini, Claude Sonnet 4.6, Claude Opus 4.6 o GPT-OSS 120B en cada ejecución.

Servidores MCP

Antigravity CLI admite servidores MCP, y si importaste tu configuración de Gemini CLI ya están conectados. Viven en tu archivo de ajustes, así que añadir uno nuevo es cuestión de editar el JSON.

// ~/.gemini/antigravity-cli/settings.json
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my/mcp-server"]
    }
  }
}

Una vez que un servidor está en el archivo de ajustes, agy se conecta a él en la siguiente sesión y sus herramientas pasan a estar disponibles dentro del agente. Es el mismo modelo de MCP que usaba el CLI antiguo, y por eso la importación trae tus servidores sin tocar nada.

Ejecutar varias sesiones de Antigravity CLI en paralelo

Una sesión de agy coordina sub-agentes para la tarea que tiene delante. Pero muchas veces quieres avanzar en varios frentes a la vez: una feature en un proyecto, un arreglo de bug en otro, documentación en un tercero. Cada uno de esos es su propia sesión de agy, su propio proceso, con su conversación y su contexto. Ejecutarlas a la vez es donde un espacio de trabajo visual se gana su sitio.

CodeAgentSwarm es una app de escritorio para macOS y Windows hecha justo para esto. Te da varios terminales en una ventana, y en el selector SELECT AI AGENT eliges el agente por terminal: claude-code, codex cli o antigravity. Pon varios terminales en antigravity y tienes una sala de control para sesiones de agy en paralelo, todo en un mismo sitio.

CodeAgentSwarm no es un proveedor de modelos. Cada sesión de agy sigue usando tu propio inicio de sesión de Google y tu propia instalación de Antigravity. La app solo le da un hogar a las sesiones y añade lo que importa cuando tienes más de una en marcha:

• Títulos dinámicos por terminal, para que en vez de pestañas "agy" idénticas veas qué está haciendo cada sesión ahora mismo
• Avisos de escritorio en cuanto una sesión termina o se para a preguntarte algo, para que dejes de estar pendiente de las pestañas (más en la guía de notificaciones)
• Historial de conversaciones buscable entre todas las sesiones, para rastrear qué hizo cualquier sesión de agy y retomarla más tarde (mira la guía de historial de conversaciones)
• Un tablero kanban que tus propias sesiones actualizan por MCP, manteniendo la foto general en una sola vista
• Turbo Mode con permisos granulares, para que una sesión vaya rápida en operaciones seguras mientras las arriesgadas quedan controladas (mira la guía de Turbo Mode)
• Diffs de archivos en vivo por terminal, para que las ediciones que se solapan entre sesiones nunca te pillen por sorpresa (mira la guía de cambios en tiempo real)

Para el paso a paso de ejecutar varias sesiones de agy a la vez, mira ejecutar varias sesiones de Antigravity CLI. Si todavía estás decidiendo si pasarte de la herramienta antigua, Antigravity CLI vs Gemini CLI te detalla exactamente qué cambió. Y como antigravity está al lado de Claude Code y Codex CLI en el mismo selector, el mismo espacio de trabajo también ejecuta varias sesiones de Claude Code y varias sesiones de Codex cuando una tarea encaja mejor con alguno de ellos.