# Migrar de Gemini CLI a Antigravity CLI: guía > Instalación de agy, migración de la configuración, los plugins y las variables de entorno; comprobaciones, errores comunes y restricciones regionales. Source: https://ailoot.ai/blog/es/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/es/gemini-cli-to-antigravity-cli-migration/ Language: es Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-f274eaa49302d1ef297bd59b3d9342de3e8ee2715523469094127b044d515b2e 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.
La conexión de modelos y el trabajo con la API se explican en la [documentación de Ailoot](https://ailoot.ai/docs/).
## ¿Qué dejará de funcionar exactamente el 18 de junio de 2026?
Puntos clave El 18 de junio de 2026, Gemini CLI y la extensión Gemini Code Assist para VS Code dejarán de procesar solicitudes para tres categorías de usuarios: los del plan Free, Google AI Pro y Google AI Ultra. Las nuevas instalaciones de Gemini Code Assist en GitHub dejarán de estar disponibles; las existentes se desactivarán «en las semanas siguientes». El acceso de pago a la API mediante Gemini Enterprise Agent Platform y las licencias Code Assist Standard/Enterprise seguirá funcionando sin cambios.
No se trata del «cierre completo del proyecto», sino del fin de los tres planes más populares. ¿A quién afecta? | Plan | Qué ofrecía | Qué ocurrirá el 18 de junio de 2026 | |----|----|----| | Plan Free | Acceso a Gemini Code Assist y CLI con límites | Se desactivará por completo | | Google AI Pro (unos \$19.99/mes) | Límites más altos para CLI y Code Assist | Se desactivará por completo | | Google AI Ultra (desde \$100/mes después de I/O 2026) | Los límites más altos | Se desactivará por completo | | Gemini Code Assist para GitHub | Revisiones automáticas de PR de Google en tu repositorio | No habrá nuevas instalaciones; las existentes se desactivarán en las semanas siguientes | | Gemini Code Assist Standard / Enterprise (licencias corporativas) | A través de una cuenta corporativa de Google Workspace | Seguirá funcionando sin cambios | | API de pago a través de Google Cloud (clave de Gemini API de pago) | Las solicitudes se facturan al proyecto | Seguirá funcionando sin cambios | Del blog oficial de Google Developers:

El 18 de junio de 2026, Gemini CLI y las extensiones IDE de Gemini Code Assist dejarán de procesar solicitudes para los usuarios de Google AI Pro, Ultra y el plan Free.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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?
Puntos clave Gemini CLI era un experimento independiente en TypeScript/Node.js dentro del repositorio de Google en GitHub. Google decidió unificar todas sus herramientas de agentes en una sola plataforma, Google Antigravity, con cuatro interfaces: Antigravity 2.0 (aplicación de escritorio), Antigravity CLI (terminal), Antigravity SDK (wrapper de Python) y Antigravity IDE (fork de VS Code). Antigravity CLI se ha reescrito de Node.js a Go: se inicia en milisegundos en lugar de cientos de milisegundos y utiliza decenas de megabytes de memoria en lugar de cientos.
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:

Antigravity CLI está escrito en Go, se ejecuta más rápido y admite flujos de trabajo asíncronos en segundo plano.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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:

El repositorio seguirá disponible en GitHub con la licencia Apache 2.0 y continuaremos trabajando en el proyecto como código abierto.

— Google Developers Blog (Discussion #27274)
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
Puntos clave El instalador de Google detecta automáticamente el sistema operativo y la arquitectura, descarga el binario y lo coloca en `~/.local/bin` (Linux/macOS) o en `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). Los comandos varían según el sistema operativo: en macOS y Linux, una sola línea con `curl`; en Windows, PowerShell `irm` o la opción de CMD. Después de instalarlo, añade la ruta a `PATH` si el instalador no lo ha hecho, abre un terminal nuevo y ejecuta `agy doctor`: comprueba que se encuentre el binario y que pueda conectarse con Google.
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`: ```bash 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: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Comprueba que el binario esté disponible: ```bash which agy agy --version ``` ### Windows (PowerShell) ```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: ```cmd 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: ```bash 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
Puntos clave Antigravity CLI busca la configuración en `.agents/`, junto al proyecto, y globalmente en `~/.agents/`, igual que Gemini CLI la buscaba en `.gemini/`. La migración se hace con un solo comando, `agy plugin import gemini`: recorre `.gemini/extensions/`, las migra como plugins de Antigravity y actualiza el formato de configuración. Mueve manualmente la carpeta de skills: `mv .gemini/skills/ .agents/skills/`. Después, `agy doctor` y `agy inspect` mostrarán qué se ha recogido, qué falta y dónde hay duplicados.
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](https://ailoot.ai/blog/es/agents-md-guide-template/), 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?
Puntos clave Si tienes scripts de CI/CD, GitHub Actions, archivos `.env` locales o archivos de configuración personal que transmiten `GEMINI_API_KEY` u otras variables, tendrás que cambiarles el nombre. El prefijo `GEMINI_` se ha convertido en `AV_` (por Antigravity). Antigravity CLI NO leerá las variables antiguas.
Tabla completa de sustituciones: | Variable anterior (Gemini CLI) | Variable nueva (Antigravity CLI) | Valor predeterminado | |----|----|----| | `GEMINI_API_KEY` | `AV_API_KEY` | \- | | `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- | | `GEMINI_REGION` | `AV_REGION` | `us-central1` | | `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` | | `GEMINI_API_BASE` | `AV_API_BASE` | Punto de conexión oficial de Google | 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_`: ```bash # 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: ```bash 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
Puntos clave Según la conversación de GitHub, los problemas más comunes son los servidores MCP definidos en `~/.gemini/config.json`, que no se recogen automáticamente: hay que reescribir la configuración en el formato de Antigravity. Los hooks personalizados que utilizan variables de entorno antiguas fallan sin avisar, por lo que las pruebas fallan sin un error claro. Hay que actualizar los scripts que acceden directamente a `.gemini/` (en lugar de hacerlo a través del CLI) para que usen `.agents/`. El comando `@[file]` para cargar un archivo en el contexto tenía errores en las primeras versiones de Antigravity CLI; se han corregido en las versiones recientes, pero si usas una antigua, actualízala.
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](https://antigravity.google) (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?
Puntos clave Antigravity CLI se inicia más rápido, funciona con Gemini 3.5 Flash, admite agentes en paralelo y tareas asíncronas en segundo plano mediante `agy --background`. Sin embargo, hay dos posibles problemas: las restricciones regionales de acceso y un ecosistema inmaduro (menos plugins y servidores MCP que Claude Code). Yo no elegiría Antigravity como herramienta principal. Lo usaría como canal de respaldo para tareas paralelas en segundo plano y mantendría Claude Code para el trabajo principal de desarrollo. Si utilizabas Gemini CLI con el plan Free, el 18 de junio es un buen momento para replantearte todo tu conjunto de herramientas.
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](https://ailoot.ai/blog/es/google-antigravity/). Resumen de qué hacer según tu situación: | Si… | Qué hacer antes del 18 de junio | |----|----| | Utilizabas Gemini CLI Free para experimentar | Migra a Antigravity CLI con una cuenta que pueda acceder al servicio O pásate a Claude/Codex, según tu presupuesto | | Utilizabas Gemini Code Assist en tu IDE | Pásate a Antigravity IDE o vuelve a VS Code + Claude Code | | Ejecutabas trabajos cron nocturnos mediante la Gemini API del plan Free | Reescríbelos urgentemente para usar la API de Cloud de pago (que no se desactivará) O pásalos a Claude API | | Trabajas mediante Cloud corporativo (Standard/Enterprise) | No hagas nada; el cierre no te afecta | | Solo pensabas probar Gemini CLI porque «es gratis» | No empieces; ve directamente a [Claude Code](https://ailoot.ai/blog/es/claude-code/) o [Codex](https://ailoot.ai/blog/es/codex-vs-claude-code-choice/) | ## Lista de verificación de la migración en 15 minutos
Puntos clave Si quieres hacerlo lo más rápido posible sin leer toda la guía, aquí tienes la secuencia breve. En un terminal nuevo, sin scripts Gemini activos, la migración completa lleva 10–20 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.
### Fuentes - [Google Developers Blog - Una actualización importante: transición de Gemini CLI a Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Primeros pasos](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - Repositorio de GitHub](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Novedades para desarrolladores de Google I/O 2026](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Sigue trabajando con IA en [Ailoot](https://ailoot.ai/).
## Preguntas sobre Antigravity ### ¿Cómo verifico la variable renombrada de clave API sin exponerla? Comprueba que `${AV_API_KEY:-}` no esté vacía e imprime solo un mensaje de presencia o ausencia. No imprimas la clave ni actives el trazado del shell; utiliza `agy doctor` por separado para revisar la autenticación. ### ¿Importar la configuración correctamente demuestra que terminó toda la migración? No. Compara plugins, skills, hooks y subagentes activos con la configuración anterior, revisa MCP y ejecuta una tarea pequeña. Conserva la antigua configuración `.gemini/` hasta verificar el flujo y el resultado previstos. ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.