AI
Migrando de Gemini a Antigravity CLI
Kevin Dávila
aiantigravity
Anteriormente hablamos de los anuncios del Google I/O 2026, y cómo estamos entrando a la era de Agent-First con Antigravity
Pues Google ha iniciado una transición fundamental en su ecosistema de desarrollo con el lanzamiento de Antigravity CLI (agy), marcando el fin de la era de Gemini CLI. Este cambio responde a la necesidad de orquestar flujos de trabajo basados en agentes autónomos en lugar de simples asistentes de chat.
Es importante realizar la migración antes del 18 de junio de 2026, fecha en la que Gemini CLI y las extensiones de Gemini Code Assist dejarán de atender solicitudes para usuarios individuales (tanto gratuitos como de los planes AI Pro y Ultra). Las cuentas empresariales con licencias de Gemini Code Assist no se ven afectadas.
Evolución hacia el Agent Harness
Antigravity CLI no es una actualización incremental; es una reingeniería completa escrita en Go que se integra con el nuevo Agent Harness de Google. Mientras que Gemini CLI se limitaba a interacciones de una sola vía, Antigravity permite la colaboración de múltiples subagentes en paralelo, compartiendo memoria y estado en tiempo real.
Paso 1: Instalación y Limpieza del Entorno
El primer paso consiste en remover la herramienta obsoleta e instalar el nuevo binario. Debido a cambios en la arquitectura de plugins, no se recomienda mantener ambas herramientas en la misma ruta global.
# Eliminación de Gemini CLI (era un paquete de npm basado en Node.js)
npm uninstall -g @google/gemini-cli
# Instalación de Antigravity CLI
# A diferencia de Gemini CLI, NO se distribuye por npm: es un binario único en Go.
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Verificación de la versión
agy --version
El instalador coloca el binario agy en ~/.local/bin/ (Unix) o %LOCALAPPDATA%\Antigravity\ (Windows). Tanto gemini como agy pueden coexistir durante la ventana de migración.
Paso 2: Migración Automatizada de Configuraciones
En su primer arranque, si detecta un directorio ~/.gemini/ existente, agy ofrece importar automáticamente la configuración. Si el aviso no aparece, puede ejecutar el comando manualmente. Este proceso trae las registraciones de servidores MCP, los comandos permitidos sin confirmación y los keybindings personalizados.
# Importar configuración de Gemini CLI
agy plugin import gemini
Este proceso moverá las configuraciones globales de ~/.gemini/settings.json hacia la nueva estructura jerárquica en ~/.gemini/antigravity-cli/settings.json. Una vez dentro de agy, puede editar estos valores con los comandos /config o /settings.
Paso 3: Reestructuración de Archivos de Proyecto
La jerarquía de archivos dentro de los repositorios ha cambiado para soportar el nuevo sistema de habilidades y configuración de agentes.
Cambios en Nombres de Archivos
Instrucciones de Proyecto: AGENTS.md es la convención recomendada para las instrucciones de proyecto de mayor nivel (compatible también con otras herramientas de agentes).
Habilidades (Skills): Las habilidades viven en ~/.gemini/skills/, con un archivo SKILL.md por habilidad (~/.gemini/skills/{nombre}/SKILL.md).
Formato de SKILLS
Cada habilidad se define en un SKILL.md con Frontmatter en YAML que describe su nombre, propósito y herramientas disponibles:
---
name: experto-backend
description: Agente especializado en arquitecturas Node.js y bases de datos.
tools: [grep_search, read_file, run_shell_command]
---
# Instrucciones
Maneja la arquitectura de todos los proyectos usando esta estructura...
Tenemos un Blog hablando de SKILLS en Claude Code, por si quieren ahondar en el tema. (Ahora son un standard, por lo que son lo mismo en Antigravity)
Paso 4: Configuración de MCP (Model Context Protocol)
Antigravity separa las definiciones de MCP en perfiles dedicados para evitar archivos de configuración masivos y facilitar la reutilización entre la CLI y la aplicación de escritorio.
Configuración Global: Se almacena en ~/.gemini/config/mcp_config.json.
Es importante notar que, en el esquema de servidores remotos, el campo anterior httpUrl ha sido reemplazado por serverUrl. Además, el parámetro timeout ya no se admite a nivel raíz.
Paso 5: Orquestación de Subagentes
Las habilidades se instalan desde repositorios de GitHub y se colocan en ~/.gemini/skills/. Una vez instaladas, quedan disponibles tanto para la CLI como para la aplicación de escritorio.
# Instalar una skill desde su repositorio
npx skills add <url-del-repositorio>
La interacción principal es a través de la sesión interactiva de agy y sus comandos de barra (slash commands). Para gestionar el trabajo no se envía un único prompt: se delega y se supervisa mediante subagentes asíncronos.
agy # inicia la sesión interactiva
# Dentro de la sesión:
/tasks # gestiona tareas y subagentes en segundo plano
/skills # lista y administra habilidades
/mcp # inspecciona servidores MCP conectados
/model # selecciona el modelo
/fast # ejecuta sin fase de planificación
Seguridad: Implementación de Guardrails
A diferencia de Gemini CLI, el Antigravity SDK (una librería de Python) permite definir límites estrictos sobre lo que un agente puede hacer en su sistema de archivos o red. El SDK usa un sistema de políticas declarativo con funciones deny, allow, ask_user y enforce, aplicado por el Harness e integrando requisitos de human-in-the-loop para acciones de riesgo.
El SDK se instala desde PyPI:
pip install google-antigravity
# Ejemplo conceptual de política sobre el uso de herramientas
from antigravity import Agent
async with Agent(name="Analista") as agent:
# Las políticas controlan el uso de herramientas: deny / allow / ask_user / enforce.
# Las acciones de riesgo (p. ej., borrar archivos) requieren confirmación explícita.
...
Consulte el repositorio oficial google-antigravity/antigravity-sdk-python para la API exacta de políticas y guardrails.
Verificación Final
Tras completar los pasos anteriores, verifique que todo se haya cargado correctamente: confirme la versión del binario y revise el estado de habilidades y servidores MCP desde la sesión interactiva.
agy --version # confirma la instalación del binario
# Dentro de la sesión de agy:
/skills # verifica las habilidades cargadas
/mcp # verifica los servidores MCP conectados
Para más detalles técnicos, consulte la guía oficial de migración en: https://antigravity.google/docs/gcli-migration
Conclusión
Migrar a Antigravity CLI no es solo un cambio de comandos, sino la adopción de una infraestructura que permite escalar la productividad mediante la delegación inteligente. El desarrollador deja de ser quien escribe cada línea de código para convertirse en el arquitecto y orquestador de un equipo de agentes altamente especializados.