Migración de Gemini CLI → Antigravity CLI

Google anunció el 19 de mayo de 2026 que Gemini CLI está en proceso de transición hacia Antigravity CLI. Para los clientes empresariales de pago, nada cambia. Para todos los usuarios con una cuenta de Google AI Pro, Ultra o Gemini Code Assist gratuita para individuos, Gemini CLI dejará de procesar solicitudes el 18 de junio de 2026. Este es el plan de migración que puedes ejecutar en una tarde, con rollback si algún flujo de trabajo crítico falla.

1. El anuncio

Dos canales de Google publicaron la transición el mismo día. El Google Developers Blog presentó el cronograma. La cuenta @geminicli en X se comprometió a un periodo de migración de 30 días para usuarios de nivel individual y una excepción explícita de "no requiere acción" para clientes enterprise.

Google DeepMind planteó el panorama general desde una cuenta oficial independiente — la CLI es una pieza de una oferta para desarrolladores de tres superficies, no un producto independiente:

La documentación oficial de migración en antigravity.google/docs/gcli-migration es la fuente de verdad para el mapeo archivo por archivo. Los pasos a continuación los siguen en orden, señalando los gotchas donde la documentación los deja implícitos.

2. TL;DR

• Fecha límite: 18 de junio de 2026 (nivel individual)
• Afectados: Google AI Pro, Google AI Ultra, Gemini Code Assist gratuito
• No afectados: Code Assist Standard / Enterprise, claves de Gemini API de pago
• Reemplazo: Antigravity CLI (binario: agy)
• Migración con un solo comando: agy plugin import gemini
• Movimientos manuales necesarios: .gemini/skills/ → .agents/skills/, configuración de MCP a mcp_config.json
• Renombrado de campos: MCP remoto url → serverUrl
• Archivos de contexto: GEMINI.md y AGENTS.md siguen funcionando sin cambios
• Instalación en paralelo: seguro — gemini y agy coexisten
• Tiempo de lectura de esta guía: 14 minutos; realizar el trabajo: unos 45 minutos

3. El cronograma

4. Quiénes se ven afectados

Realiza esta comprobación rápida antes de seguir leyendo:

• Inicias sesión en Gemini CLI con una cuenta personal de Google. Te ves afectado — este es el flujo gratuito / para consumidores.
• Pagas por Google AI Pro o Google AI Ultra. Te ves afectado. Antigravity CLI utiliza la misma suscripción.
• Utilizas Gemini Code Assist para particulares (nivel gratuito). Te ves afectado. Tanto Gemini CLI como la extensión de IDE de Code Assist dejarán de funcionar el 18 de junio.
• Autenticas Gemini CLI con una API key de Gemini de pago. No te ves afectado. Gemini CLI continúa para los usuarios de API key de pago.
• Tu organización tiene una licencia de Gemini Code Assist Standard o Enterprise. No te ves afectado. El acceso a la CLI de Enterprise se mantiene sin cambios.

5. Excepción para Enterprise

Según el blog de Google Developers: “Si su organización utiliza Gemini CLI o nuestras extensiones de IDE a través de una licencia de Gemini Code Assist Standard o Enterprise, o si su organización utiliza Gemini Code Assist para GitHub a través de Google Cloud, su acceso permanecerá sin cambios. Continuaremos brindando soporte a Gemini CLI y Gemini Code Assist con acceso a los últimos modelos de Gemini y otras actualizaciones.”

Concretamente, las empresas conservan tres opciones:

• Mantener Gemini CLI con licencia Standard / Enterprise — no se requiere migración.
• Mantener Gemini CLI con una API key de pago — no se requiere migración.
• Adoptar Antigravity CLI de forma paralela, utilizando credenciales de proyecto de GCP. Consulte la página oficial para empresas para obtener detalles sobre la vinculación de proyectos de GCP.

Si usted es un administrador de empresa leyendo esto para alguien más, el titular para usted es planifique un piloto, no realice una migración por pánico en la organización. La fecha límite solo afecta al nivel de consumidor.

6. Lista de verificación previa

Antes de comenzar la migración, confirme:

• Su máquina puede instalar un binario distribuido en Go (agy) — tiene acceso a curl, irm o a la terminal de administrador.
• Sabe qué cuenta de Google está configurada en su Gemini CLI actualmente (la migración mantiene la misma cuenta).
• Puede listar sus extensiones de Gemini CLI instaladas (gemini extension list).
• Su ~/.gemini/ directorio está intacto (contiene sus reglas y habilidades globales).
• Proyectos de Workspace con carpetas .gemini/ personalizadas identificadas — cada una requiere un movimiento manual para las skills de alcance de workspace.
• Si automatizas llamadas a la CLI de Gemini desde CI o cron, necesitas un plan de transición para cambiar el nombre del binario (gemini → agy) y el flujo de autenticación.

7. Paso 1: Instalar Antigravity CLI

Un comando de instalación por plataforma, desde el README oficial:

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

# 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

Después de la instalación, verifica:

agy --version
# expected: a version string is printed

El binario se llama agy, no antigravity. Si automatizas llamadas a la CLI, este es el cambio de nombre. El binario de Gemini CLI's geminipermanece en su lugar; ambos coexisten.

8. Paso 2: Autenticar

La primera ejecución abre un flujo de autenticación. Dos variantes:

• Terminal local. Ejecuta agy. Se abrirá tu navegador predeterminado. Inicia sesión con la misma cuenta de Google que usaste para Gemini CLI. El token se almacena en el llavero del sistema.
• Remoto / SSH. Ejecuta agy. La CLI detecta la sesión SSH e imprime una URL de autorización. Ábrela en tu máquina local, completa el flujo de OAuth y la sesión SSH obtendrá el token. Esto era un problema notable en las primeras versiones de Gemini CLI — ahora cuenta con soporte nativo.
• Enterprise. Durante el onboarding puedes conectar un proyecto de GCP. Las llamadas se facturarán a ese proyecto. La documentación oficial de enterprise cubre los detalles específicos.

9. Paso 3: Importar Plugins

On first launch, Antigravity CLI prompts to migrate Gemini CLI extensions to Antigravity plugins. If you skip the prompt or are installing on a fresh machine, run the import explicitly:

agy plugin import gemini

Ejemplo de salida de la documentación oficial de migración, recorriendo una extensión multicomponente:

[ok]    conductor
          - skills      : skipped (not found)
          - agents      : skipped (not found)
          ✔ commands    : 6 processed (converted to skills)
          - mcpServers  : skipped (not found)
          - hooks       : skipped (not found)
[ok]    google-workspace
          ✔ skills      : 6 processed
          - agents      : skipped (not found)
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          - hooks       : skipped (not found)

10. Paso 4: Mover las configuraciones de MCP

Gemini CLI almacenaba los servidores MCP de forma integrada en settings.json. Antigravity CLI utiliza un archivo independiente. Muévelos:

Y un cambio de nombre de campo en el propio JSON:

// Gemini CLI (settings.json)
{
  "mcpServers": {
    "my-remote-mcp": {
      "url": "https://example.com/mcp"   // or the deprecated "httpUrl"
    }
  }
}

// Antigravity CLI (mcp_config.json)
{
  "my-remote-mcp": {
    "serverUrl": "https://example.com/mcp"
  }
}

Los servidores MCP remotos fallarán silenciosamente si copias url sin renombrarlo. Las entradas de servidores MCP locales con command + args no necesitan el cambio de nombre. Para más información sobre la configuración de MCP, consulta nuestro tutorial de MCP.

11. Paso 5: Mover las habilidades del espacio de trabajo (Workspace Skills)

Las habilidades globales bajo ~/.gemini/skills/ se cargan automáticamente — no se requiere ninguna acción. Las habilidades del espacio de trabajo bajo .gemini/skills/ deben moverse a .agents/skills/:

# Per project, from the workspace root:
mkdir -p .agents
git mv .gemini/skills .agents/skills
# Or, if not in git:
mv .gemini/skills .agents/skills

Si un espacio de trabajo ya tenía una .agents/skills/ carpeta (el caso de ubicación dual que permitía la documentación de Gemini CLI), conserva esa y elimina la .gemini/skills/ copia. Para patrones de autoría, consulta nuestro Guía de configuración de habilidades de Antigravity.

12. Paso 6: Verificar Hooks y Contexto

Dos cosas que debes confirmar antes de dar por terminada la migración:

• Los archivos de Contexto se cargan. GEMINI.md y AGENTS.md en el workspace, además de ~/.gemini/GEMINI.md a nivel global, todo sigue funcionando sin cambios. Abre una sesión y pídele al agente que recite una regla conocida de tu archivo.
• Los hooks de JSON se ejecutan. Si creaste hooks de JSON para Antigravity 2.0 o Gemini CLI, estos se aplican en Antigravity CLI en los mismos momentos del ciclo de vida. Modifica un archivo o ejecuta una llamada de herramienta de ejemplo para confirmar que un hook que conozcas realmente se ejecute.

Para patrones de reglas, consulta nuestros ejemplos de reglas y la guía de system prompt de GEMINI.md.

13. Paso 7: Validación con tareas reales

El único paso que no debes saltarte. Elige una tarea que hayas realizado ayer en Gemini CLI — un refactor, una sesión de investigación o una edición de múltiples archivos — y ejecútala en Antigravity CLI en el mismo repositorio. Compara:

• ¿El agente utilizó las mismas herramientas en los mismos pasos?
• ¿Tus comandos slash de habilidades se activaron en los lugares correctos?
• ¿Se ejecutaron las llamadas al servidor MCP? (Atento a los serverUrl fallos silenciosos aquí).
• ¿Los archivos de contexto (GEMINI.md, AGENTS.md) influyeron en el comportamiento de la misma manera?
• ¿Se invocaron los hooks en los momentos del ciclo de vida que esperabas?

Dedicar entre veinte y treinta minutos a una tarea representativa te da el 90% de la señal que necesitas. Si todo se reproduce, habrás terminado. Si algo falla, regístralo y vuelve a Gemini CLI para ese flujo de trabajo hasta que tengas una solución.

14. Plan de rollback

Antigravity CLI y Gemini CLI coexisten en la misma máquina. Son binarios independientes (agy vs gemini), con árboles de configuración separados (~/.gemini/antigravity-cli/ junto a ~/.gemini/), y flujos de autenticación separados. Hasta el 18 de junio de 2026, tu rollback para cualquier workflow individual es simplemente: seguir ejecutando gemini para esa tarea específica.

Después del 18 de junio, las opciones de rollback se reducen a:

• Actualizar a una licencia enterprise (Gemini Code Assist Standard / Enterprise).
• Cambiar a una API key de Gemini de pago.
• Usar Antigravity 2.0 (la GUI) en lugar de la CLI para el workflow afectado.
• Usar un CLI de agente completamente diferente. Consulta nuestro resumen de alternativas para conocer el panorama actual.

15. Resumen de los cambios

16. FAQ

17. Veredicto

Si solo haces una cosa hoy: instala Antigravity CLI en la máquina donde más usaste Gemini CLI. A partir de ahí, todo lo demás requiere un esfuerzo menor.

Fuentes

• Google Developers Blog — Una actualización importante: Transición de Gemini CLI a Antigravity CLI
• @geminicli en X — anuncio de la transición
• Antigravity CLI — Migración desde Gemini CLI (documentación oficial)
• Presentamos Google Antigravity CLI — antigravity.google
• Presentamos Google Antigravity 2.0 — antigravity.google
• Descripción general de Antigravity CLI — documentación oficial
• google-antigravity/antigravity-cli — repositorio de GitHub