Migrar de Gemini CLI a Antigravity CLI: guía

El 19 de mayo de 2026, Google anunció que cerraría el antiguo Gemini CLI para todos los planes Free, Pro y Ultra el 18 de junio. Dos semanas después de la publicación de esta guía, el comando gemini dejará de procesar solicitudes. Migrar de Gemini CLI a Antigravity CLI con el comando agy es la única forma de seguir usando las herramientas de Google. agy está escrito en Go y se inicia decenas de veces más rápido.

Si tienes algo en marcha con Gemini CLI —scripts de CI, trabajos cron nocturnos, la extensión IDE Gemini Code Assist—, esta guía explica cómo migrar en una tarde sin romper nada.

¿Qué dejará de funcionar exactamente el 18 de junio de 2026?#

No se trata del «cierre completo del proyecto», sino del fin de los tres planes más populares. ¿A quién afecta?

Del blog oficial de Google Developers:

Si usabas el plan Free, como la mayoría de los desarrolladores individuales, y piensas «pero tengo una cuenta de pago», comprueba exactamente cómo se factura tu clave de API. AI Pro no es facturación de Cloud: es una suscripción personal a Google AI y se desactivará. La facturación de Cloud con un proyecto de pago no se desactivará.

¿Por qué va a cerrar Google Gemini CLI?#

El antiguo gemini tardaba «cientos de milisegundos» en iniciarse porque Node.js necesitaba arrancar. El nuevo agy se ha compilado como un único binario estático de Go y se inicia en «milisegundos». En CI y en scripts que llaman al CLI cientos de veces por ejecución, la diferencia es considerable.

Esto es lo que dice Google sobre la velocidad y el motivo:

Se han trasladado todas las funciones importantes de Gemini CLI:

• Agent Skills — la carpeta .gemini/skills/ ahora está en .agents/skills/.
• Hooks — los mismos eventos (PreToolUse, PostToolUse, etc.); la sintaxis apenas ha cambiado.
• Subagents — funcionan como antes y su configuración se migra automáticamente.
• Extensions — ahora se llaman plugins de Antigravity y se importan con un solo comando.

Lo que no se migró sin problemas: los servidores MCP y los scripts antiguos que acceden directamente a .gemini/config.json. Según la conversación de GitHub, algunos usuarios informan de que las configuraciones de MCP dejan de funcionar y hay que reescribirlas manualmente. Más abajo hay una sección específica sobre este tema.

Google no va a cerrar el proyecto de código abierto Gemini CLI:

Eso significa que puedes hacer un fork y seguir usándolo con tu propia clave de Gemini API. Pero ahora será una configuración de pago a través de la facturación de Cloud; la opción gratuita de Code Assist desaparece.

Cómo instalar Antigravity CLI: comandos para macOS, Linux y Windows#

Antes de empezar, haz una comprobación rápida: ¿qué plan tienes? Si tienes un proyecto de Cloud de pago y no te afecta la fecha límite del 18 de junio, migrar es útil, pero no urgente. Si tienes Free/Pro/Ultra y algo en ejecución con el CLI, cámbiate ahora, mientras los planes siguen activos, para poder comparar el comportamiento con la misma tarea.

macOS y Linux

Una sola línea con curl:

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

El script detecta la plataforma, descarga el binario agy, comprueba su suma de verificación y lo coloca en ~/.local/bin. Si esta carpeta no está en PATH, añádela:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Comprueba que el binario esté disponible:

which agy
agy --version

Windows (PowerShell)

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

El binario se instalará en C:\Users\[your_name]\AppData\Local\agy\bin. El instalador actualizará PATH automáticamente, pero abre una ventana nueva de PowerShell para volver a cargar las variables.

Windows (CMD)

Si la política de tu empresa bloquea PowerShell:

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

Verificar la instalación

Después de instalarlo en cualquier sistema operativo, ejecuta:

agy doctor

El comando comprueba la versión del binario, si existe una configuración, la autenticación y el acceso de red a antigravity.google. Si no puede conectarse con Google, el problema está en tu región o en el proxy.

Autenticación

La primera vez que ejecutas agy sin argumentos, se inicia un asistente de configuración:

1. Elige un tema para la interfaz.
2. Elige un método de autenticación: Google OAuth (para cuentas personales) o una clave de API.
3. Si quieres, importa la configuración de .gemini/ en ese momento.

Si eliges OAuth, se abrirá un navegador y te redirigirá a accounts.google.com; tendrás que dar tu consentimiento para compartir datos. Después, el CLI estará listo.

Cómo migrar la configuración y los plugins de .gemini a .agents#

Paso a paso:

1. agy plugin import gemini

   Ejecuta el comando desde cualquier carpeta. Migrará los plugins globales de ~/.gemini/ a ~/.agents/. Para los plugins del espacio de trabajo (junto al proyecto), ejecuta el comando desde la carpeta del proyecto.

2. mv .gemini/skills/ .agents/skills/

   Mueve las skills cambiando el nombre de la carpeta manualmente. El formato de los archivos sigue siendo el mismo; no hace falta reescribir el Markdown.

3. agy inspect

   Muestra qué plugins, skills, hooks y subagents están activos. Compara la lista con la que tenías en Gemini CLI: no debería faltar nada.

4. agy config --edit

   Abre la configuración en el editor predeterminado ($EDITOR). Si algo no se ha recogido automáticamente, edítalo manualmente.

5. agy doctor

   Comprobación final: binario, autenticación, plugins y red. Si los cuatro elementos están en verde, la migración de la configuración está completa.

Yo dejaría la antigua carpeta .gemini/ como copia de seguridad durante un mes, por si se ha pasado algo por alto. Cuando lleves una semana usando Antigravity y hayas confirmado que está todo, podrás eliminarla.

Si utilizas AGENTS.md como configuración universal para todas las herramientas de IA, no tienes que tocarlo. Antigravity CLI lee AGENTS.md en la misma carpeta que Claude Code o Codex.

¿Qué variables de entorno hay que cambiar?#

Tabla completa de sustituciones:

Si tienes GitHub Actions que transmiten secretos, abre Settings -> Secrets -> Actions y cambia el nombre de las claves. Los valores no cambian (la clave de la API de Google no ha cambiado durante la migración).

Comprueba todos los sitios donde pueda aparecer GEMINI_:

# Buscar menciones en todo el proyecto
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# En los archivos de configuración personales
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Después de sustituirlas, reinicia el terminal y comprueba la presencia sin imprimir el secreto. No actives el trazado del shell ni copies claves en registros. La presencia no demuestra autorización; revisa agy doctor por separado:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor        # debería mostrar “authorized”

Qué suele fallar durante la transición y cómo solucionarlo#

Lista de comprobación de los problemas iniciales:

1. Servidores MCP. Si utilizabas mcp_servers en .gemini/config.json, puede que no se recojan después de ejecutar agy plugin import gemini. Compruébalo con agy inspect: debería aparecer una sección mcp. Si está vacía o contiene errores, reescríbela manualmente con agy config --edit. El formato se describe en la documentación oficial de Antigravity (busca la sección de MCP).

2. Hooks personalizados. Si tenías un script bash en .gemini/hooks/ que leía $GEMINI_API_KEY, dejará de funcionar. Busca esos casos: bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   Sustituye las variables.

3. CI/CD. En GitHub Actions o GitLab CI, cambia a agy los pasos que usan el comando gemini. El nombre del binario del instalador puede variar, así que crea una abstracción con la variable $CLI_CMD.

4. Extensión IDE. La extensión Gemini Code Assist para VS Code se desactivará junto con el CLI. La alternativa es Antigravity IDE (un fork independiente de VS Code) o AGENTS.md en cualquier otro editor de IA.

5. Carga con @[file]. Las primeras versiones de Antigravity CLI tenían errores con el comando @src/file.ts para cargar un archivo en el contexto. Actualiza a la última versión: agy update.

Si algo crítico deja de funcionar y no puedes arreglarlo en una hora, una solución temporal para el plan Free es seguir con Gemini CLI hasta el 18 de junio mientras configuras la migración en una rama aparte del repositorio. Límite de tiempo: 14 días.

¿Vale la pena seguir usando las herramientas de Google después del 18 de junio?#

Antigravity 2.0 puede considerarse una opción de respaldo para los casos en que tu herramienta principal (Claude Code o Codex) no sea adecuada. Para conocer en detalle sus ventajas y desventajas, consulta la guía de Google Antigravity 2.0.

Resumen de qué hacer según tu situación:

Lista de verificación de la migración en 15 minutos#

1. Instala Antigravity CLI

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) o irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. Inicia agy y autentícate

   Sin argumentos: agy. Elige OAuth o una clave de API.

3. Importa los plugins de .gemini

   agy plugin import gemini — migra las extensiones globales. Vuelve a ejecutarlo en la carpeta del proyecto para migrar los plugins del espacio de trabajo.

4. Mueve las skills

   mv .gemini/skills/ .agents/skills/. El contenido de los archivos no cambia.

5. Sustituye las variables de entorno

   En ~/.zshrc/~/.bashrc y en los archivos .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Reinicia el terminal.

6. Verifica la instalación

   agy doctor — los cuatro elementos (binario, autenticación, plugins y red) deberían estar en verde.

7. Ejecuta una tarea de prueba

   agy "escribe un README para el proyecto en la carpeta actual" — comprueba que el resultado sea similar al que producía Gemini CLI.

8. Actualiza GitHub Actions / GitLab CI

   Cambia el nombre del comando y los secretos de GEMINI_* a AV_*.

9. Conserva .gemini/ como copia de seguridad

   Puedes eliminarlo 1–2 semanas después de confirmar que todo funciona.

Y, por último: el 18 de junio no significa que «todos tus proyectos se vayan a caer». Significa que se desactiva el canal gratuito. El acceso de pago a Cloud API seguirá disponible, el repositorio de Gemini CLI seguirá en línea y se podrán crear forks. Si utilizabas el plan Free, tienes que decidir antes del 18 de junio; de lo contrario, la próxima solicitud gemini "algo" devolverá un error de autorización.