Antigravity CLI: el agente de IA de Google que reemplaza a Gemini CLI desde tu terminal
Google lanza Antigravity CLI, el sucesor de Gemini CLI con agentes autónomos
En Google IO 2026, Google presentó Antigravity CLI, una herramienta de terminal que lleva las capacidades de los agentes de IA directamente a la línea de comandos. El binario se llama agy y reemplaza al ya retirado Gemini CLI, ofreciendo razonamiento multi-paso, edición de archivos, ejecución de comandos y orquestación de subagentes —todo desde la terminal, sin necesidad de una GUI.
Antigravity CLI complementa a Antigravity 2.0, la aplicación de escritorio de Google para codificación agéntica. Ambos productos comparten el mismo motor de agentes (agent harness), lo que significa que las mejoras del núcleo se aplican automáticamente a ambas superficies. La CLI está optimizada para velocidad, eficiencia con teclado y sesiones remotas SSH con mínima sobrecarga de recursos.
Antigravity CLI vs Antigravity 2.0
| Aspecto | Antigravity CLI | Antigravity 2.0 |
|---|---|---|
| Enfoque | Velocidad, eficiencia con teclado, baja sobrecarga | Completitud, orquestación visual, gestión de proyectos |
| Interfaz | Terminal User Interface (TUI) | Aplicación de escritorio con GUI completa |
| Casos de uso | Sesiones SSH/remotas, flujos keyboard-first | Workspaces locales, orquestación pesada |
| Motor de agentes | Compartido | Compartido |
Instalación
Antigravity CLI se instala como un binario nativo mediante un script oficial. No requiere npm ni dependencias previas —solo curl en macOS/Linux o PowerShell en Windows.
macOS y Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
El script detecta la plataforma, descarga el binario correspondiente, verifica el checksum y coloca agy en ~/.local/bin. Si el directorio no está en tu PATH, el instalador te indicará cómo agregarlo:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
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
Verificar la instalación
agy --version
# 1.1.9 (o superior)
Nota importante sobre máquinas virtuales
Si tu primer comando agy falla con un error fatal y core dump, es probable que estés en una máquina virtual. El binario está compilado con AES hardware habilitado y no inicia si la CPU no expone el set de instrucciones AES. La solución es exponer la CPU del host al guest (en Proxmox/KVM, setear el tipo de CPU a host y hacer cold-boot).
Autenticación
No hay un subcomando login. La autenticación se dispara la primera vez que ejecutás algo que necesita el modelo:
agy -p "say hi"
En desktop, abre tu navegador para OAuth con tu cuenta de Google. En SSH, imprime una URL de autorización que debés abrir en un navegador, aprobar el consentimiento y pegar el código de vuelta en la terminal. Una cuenta gratuita de Google funciona durante el preview con límites de uso generosos.
Primera sesión
Iniciá la CLI con:
agy
La primera vez te pedirá confirmar que confías en el contenido del directorio de trabajo. Luego podés escribir instrucciones en lenguaje natural y el agente las ejecutará:
> Creá un componente React que liste tareas con persistencia en localStorage
Para ver todos los comandos disponibles, escribí /help. Se abrirá un panel con tres pestañas: general, comandos y atajos de teclado.
Características principales
1. Razonamiento multi-paso y edición de archivos
Antigravity CLI entiende tu codebase, hace ediciones con tu permiso y ejecuta comandos directamente desde la terminal. Puede planificar, razonar y experimentar en horizontes temporales más largos que un chatbot convencional.
2. Subagentes paralelos
La CLI soporta delegación asíncrona de tareas. Cuando le das un objetivo complejo, puede spawnear subagentes independientes que trabajan en paralelo sin bloquear tu shell activo.
/agents— abre el panel interactivo de subagentes en ejecución, completados o bloqueadosCtrl+J— teletransportarse a la próxima aprobación pendienteCtrl+K— aprobar rápidamente desde la barra de alertas sin cambiar de ventana
3. Agentes personalizados en Markdown
A partir de la versión 1.1.4, podés definir agentes personalizados usando archivos Markdown (agent.md) con frontmatter YAML y system prompts delimitados por H1. Los campos soportados incluyen mainAgent, subagent, hidden, inheritMcp, commandExecutionPolicy y model para seleccionar el tier del modelo.
agy --agent mi-agente-personalizado
4. Control de esfuerzo de razonamiento
El comando /effort permite ver y cambiar el nivel de razonamiento del modelo al vuelo, con un selector visual tipo timeline. También podés usar el flag --effort al lanzar la CLI:
agy --effort high
# o dentro de la sesión:
/effort high
5. Print mode con salida estructurada
Para integración en CI, scripts y eval harnesses, el print mode (-p) soporta salida estructurada y legible por máquina:
# Salida JSON
agy -p "revisa este diff" --output-format json
# Stream NDJSON con eventos tipados
agy -p "analiza el código" --output-format stream-json
# Con schema JSON personalizado
agy -p "extrae datos" --output-format json --json-schema schema.json
El formato stream-json emite eventos tipados (init, step_update, result) con un discriminador de vocabulario cerrado, e incluye información de herramientas y subagentes para correlación de trayectorias.
6. Arquitectura de plugins
Los plugins son bundles de directorio namespaced que agrupan skills, reglas, hooks y servidores MCP como una sola unidad desplegable:
~/.gemini/antigravity-cli/
├── plugins/
│ └── mi-plugin/
│ ├── plugin.json # Metadata requerida
│ ├── mcp_config.json # Definiciones de servidores MCP
│ ├── hooks.json # Hooks de eventos
│ ├── skills/ # Workflows de agentes (.md)
│ ├── agents/ # Blueprints de agentes personalizados
│ └── rules/ # Reglas de workspace (.md)
└── import_manifest.json
Gestión de plugins desde la terminal:
agy plugin list # Listar plugins instalados
agy plugin install <source> # Instalar desde URL o path
agy plugin update --all # Actualizar todos
agy plugin uninstall <name> # Desinstalar
7. Servidores MCP
Antigravity CLI soporta Model Context Protocol para conectar herramientas externas:
agy mcp add postgres npx @modelcontextprotocol/server-postgres
agy mcp list
agy mcp enable <name>
agy mcp disable <name>
Dentro de la sesión, /mcp abre el gestor interactivo de servidores MCP.
8. Sandbox de terminal
La CLI puede ejecutar comandos en un sandbox aislado para mayor seguridad:
- macOS:
sandbox-exec - Linux:
nsjail - Windows: AppContainer
Activá el sandbox al lanzar:
agy --sandbox
9. Búsqueda de código en vivo
El comando /codesearch (o /cs, /search) renderiza resultados progresivamente a medida que se stream-in, muestra un contador en vivo y permite cancelar la búsqueda con Esc.
10. Slash commands y atajos
| Comando | Propósito |
|---|---|
/agents | Panel de subagentes en background |
/config o /settings | Editor de configuración interactivo |
/model | Selector de modelo con gauge de esfuerzo |
/effort | Ver o cambiar esfuerzo de razonamiento |
/plan | Modo planificación |
/diff | Diff de archivos editados por el agente |
/fork | Bifurcar la conversación actual |
/rewind o /undo | Deshacer el último paso |
/skills | Explorar skills cargados |
/mcp | Gestor de servidores MCP |
/hooks | Explorar hooks activos |
/tasks | Panel de tareas en background |
/btw | Pregunta rápida sin iniciar un run de código |
/add-dir | Agregar directorio al workspace |
! | Ejecutar comando de shell directamente |
Migración desde Gemini CLI
Google retiró Gemini CLI el 18 de junio de 2026. Las cuentas gratuitas, Pro y Ultra ya no pueden usar el binario gemini. Antigravity CLI es el sucesor oficial y Google proporciona guías de migración para transferir skills, servidores MCP y personalizaciones existentes.
El antiguo paquete npm gemini-cli está deprecado. Antigravity CLI se distribuye como binario nativo, no como paquete npm. Las configuraciones de Gemini CLI en ~/.gemini/ son en gran parte compatibles con Antigravity CLI, que lee desde ~/.gemini/antigravity-cli/.
Archivos de configuración importantes
| Archivo | Ubicación |
|---|---|
| Settings | ~/.gemini/antigravity-cli/settings.json |
| Keybindings | ~/.gemini/antigravity-cli/keybindings.json |
| Logs | ~/.gemini/antigravity-cli/log/cli-*.log |
| Conversaciones | ~/.gemini/antigravity-cli/conversations/ |
| Plugins | ~/.gemini/antigravity-cli/plugins/ |
| Historial | ~/.gemini/antigravity-cli/history.jsonl |
Conclusión
Antigravity CLI es la apuesta de Google para la codificación agéntica desde la terminal. Con su arquitectura de subagentes paralelos, plugins, soporte MCP, salida estructurada para CI y agentes personalizados en Markdown, ofrece una experiencia completa que va más allá de un simple chatbot de terminal. Para desarrolladores que ya usaban Gemini CLI, la migración es directa. Y para nuevos usuarios, la instalación toma menos de 5 minutos con una sola línea de comando.
El proyecto es open source y está disponible en github.com/google-antigravity/antigravity-cli. La documentación oficial está en antigravity.google/docs/cli/overview.