Antigravity CLI (agy) en un servidor

Desde el 18 de junio de 2026, Gemini CLI ya no da servicio a cuentas personales gratuitas, de Google AI Pro ni de Ultra. El anuncio de Google remite a esos usuarios a Antigravity CLI, agy. En un servidor, lo que requiere atención es iniciar sesión sin navegador, elegir entre el inicio de sesión de Google y una clave de API, y saber cómo gestiona agy los permisos cuando no hay nadie delante del terminal. Aquí van, por orden.

Instalar agy

En Linux o macOS, con tu usuario normal (no root):

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"   # if ~/.local/bin isn't on PATH yet
command -v agy

La página oficial de instalación indica que el binario va a ~/.local/bin/agy y menciona macOS, Linux y Windows. El instalador descarga una build para cada plataforma, con builds de Linux para amd64 y arm64, así que un VPS ARM sirve. Añade la línea de PATH a ~/.bashrc o ~/.profile para que las nuevas shells y ventanas de tmux la recojan.

Un detalle propio de los servidores: agy se actualiza solo en segundo plano. En un portátil es cómodo. En una máquina que dejas encendida, significa que la versión puede cambiar en mitad de una sesión larga. Maude fija la versión que instala y desactiva esto con AGY_CLI_DISABLE_AUTO_UPDATE=1. Si quieres la misma previsibilidad, exporta esa variable en la shell o la unidad que arranca agy.

Inicio de sesión por SSH

Arranca agy en una sesión SSH y elige el inicio de sesión de Google. En un portátil abriría un navegador. Por SSH detecta la sesión remota y, en su lugar, muestra una URL de autorización. Después:

1. Copia la URL y ábrela en el móvil o en el portátil.
2. Inicia sesión con la cuenta de Google que usas para Antigravity.
3. Copia el código que te da la página y pégalo en el terminal.

Las credenciales se guardan en el llavero del sistema, que en Linux es el Secret Service. Un VPS pelado no tiene sesión de escritorio que desbloquee un llavero. Un issue de GitHub abierto contra agy 1.0.0 describe un bucle de inicio de sesión en Linux headless causado justo por eso, además de un bug de zona horaria en el respaldo basado en archivo. La solución del autor fue GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. No hemos confirmado si las versiones actuales todavía lo necesitan. Si agy te pide iniciar sesión cada vez que lo abres, ese issue es lo primero que hay que mirar. Si no, usa el modo con clave de API.

Para cerrar sesión y borrar el perfil guardado, ejecuta /logout dentro de agy.

Modo con clave de API para uso headless

Para CI, una máquina compartida o cualquier servidor en el que prefieras no mantener una sesión de Google, ejecuta agy con una clave de API de Gemini. La documentación de instalación da dos pasos. Primero, define el proveedor de modelos en ~/.gemini/antigravity-cli/settings.json. Combínalo con el archivo si ya existe:

{
  "modelProvider": "gemini"
}

Después, haz que la clave esté disponible para el proceso:

export GEMINI_API_KEY="…"   # e.g. in ~/.profile, or an EnvironmentFile for a systemd unit

Así te saltas por completo el inicio de sesión con cuenta. El uso se factura por token según los precios de la API de Gemini, en lugar de descontarse de un plan de Google AI. Mantén la clave fuera del historial de la shell y fuera del repositorio en el que trabaja el agente.

Permisos cuando nadie está mirando

Este es el comportamiento en servidor que más sorprende. En nuestras pruebas con agy 1.2.14, las ejecuciones headless (agy -p …, o el modo stream-json) no pueden pararse a preguntar antes de ejecutar una herramienta. Un comando o una escritura de archivo que necesita permiso se deniega, y el resultado del turno lo marca como denegado. Tienes tres formas de dejar pasar el trabajo:

• Reglas de permiso. agy las lee de permissions.allow en ~/.gemini/antigravity-cli/settings.json. Las entradas tienen esta forma: "command(npm test)", "write_file(src/app.ts)" o "command(*)". Se leen al arrancar.
• Modos. --mode accept-edits aprueba automáticamente las ediciones de archivos, aunque los comandos se siguen denegando. --mode plan planifica sin actuar.
• Ninguna comprobación. --dangerously-skip-permissions, para una máquina desechable. Lee cómo ejecutar agentes con todos los permisos de forma segura antes de recurrir a ello.

agy en modo interactivo en un terminal, y Remote Control (más abajo), sí pueden pararse y preguntar. Así que esta limitación afecta en concreto al uso headless y con scripts.

Traer tu configuración de Gemini CLI

La guía de migración lo cubre. La versión corta para un servidor que ya tenía Gemini CLI:

• El primer arranque ofrece migrar. Si agy encuentra configuración de Gemini CLI, muestra una lista de extensiones y ajustes globales para convertir.
• Las extensiones pasan a ser plugins. Ejecuta agy plugin import gemini cuando quieras para convertir las extensiones de Gemini en plugins de Antigravity.
• Los archivos de contexto funcionan tal cual. GEMINI.md (del workspace y ~/.gemini/GEMINI.md) y AGENTS.md se leen sin cambios.
• Los servidores MCP necesitan un pequeño cambio. Los globales están en ~/.gemini/config/mcp_config.json y los del workspace en .agents/mcp_config.json. Renombra las claves antiguas url/httpUrl a serverUrl.
• Las skills cambian de sitio. Las del workspace pasan de .gemini/skills/ a .agents/skills/, y las globales a ~/.gemini/antigravity-cli/skills/. Tienes que moverlas tú.

Google dice que todavía no hay paridad completa de funciones, y la guía de migración señala que algunos temas personalizados y ajustes visuales no se trasladan. Si un flujo de trabajo depende de una extensión concreta, pruébalo después de importarla y antes de borrar la configuración antigua.

El daemon de Remote Control frente a Maude

Google ofrece una forma oficial de acceder a agy desde otro dispositivo. Según la documentación de Remote Control, puedes iniciarlo de tres maneras:

• /remote-control dentro de una sesión en marcha. El túnel termina cuando sale esa sesión de la CLI.
• agy --remote-control al iniciar una sesión. Este túnel también termina cuando sale la sesión.
• El daemon headless: agy remote-control start --name my-vps, con agy remote-control status y agy remote-control stop. Registra un servicio del sistema que sigue funcionando en segundo plano.

Lo controlas desde un panel web en cualquier navegador, con la misma cuenta de Google. La documentación dice que puedes añadir el panel a la pantalla de inicio del móvil para recibir notificaciones push, y que puedes responder a las solicitudes de permiso desde el terminal o desde la interfaz remota. También indica que un flag de función de la cuenta o de la organización puede bloquearlo.

Si Antigravity es el único agente que usas y tu cuenta tiene activado el flag, el daemon oficial es la primera opción obvia. Es gratis y puede preguntar antes de actuar.

Úsalo desde el móvil

Si quieres agy en un servidor junto a otros agentes y manejarlo desde una app nativa, Maude es una opción. Añade el servidor y la app instala agy en una versión probada e inicia la sesión desde el móvil. Puedes usar el inicio de sesión de Google con un código pegado o una clave de API de Gemini. Para ser claros sobre Antigravity en Maude: como Maude maneja agy en modo headless, no puede pararse a preguntar antes de ejecutar una herramienta. Maude te muestra la acción denegada y, si la apruebas, añade una regla de permiso y la reintenta. La página del agente Antigravity tiene los detalles. El cambio de Gemini CLI en sí, y las alternativas a las que se ha pasado la gente, se tratan en nuestro artículo sobre el cierre de Gemini CLI.

Preguntas frecuentes

Qué ha cambiado

• 1 de octubre de 2026 — Primera publicación. Detalles de instalación, autenticación, migración y Remote Control comprobados con la documentación de antigravity.google; el comportamiento de permisos en modo headless procede de nuestras propias pruebas con agy 1.2.14.