¿Antigravity CLI es gratis?

Puedes entrar con una cuenta personal de Google en el plan Free, Pro o Ultra. Según la página de planes de Google, los demás planes tienen una cuota que se renueva cada semana, y Pro y Ultra una mayor que se renueva cada cinco horas. Google no publica cifras exactas.

¿Antigravity CLI lee mi GEMINI.md?

Sí. Lee AGENTS.md y GEMINI.md en la carpeta donde lanzas agy y en las carpetas superiores hasta la raíz del repo, además de archivos globales como ~/.gemini/GEMINI.md. Al venir de Gemini CLI no hace falta cambiar nada.

¿Dónde se configuran los servidores MCP en Antigravity CLI?

En un mcp_config.json aparte: ~/.gemini/config/mcp_config.json para todos los proyectos o .agents/mcp_config.json para un workspace. Los servidores remotos usan serverUrl y deben hablar Streamable HTTP.

¿Qué sustituye a --approval-mode y a yolo?

La opción --mode, con default, accept-edits, auto y plan. Shift+Tab cambia de modo dentro de la sesión. Para saltarse todas las confirmaciones existe --dangerously-skip-permissions, razonable solo en un entorno aislado.

¿Puedo seguir usando Gemini CLI?

Sí, si tienes una licencia de Gemini Code Assist Standard o Enterprise o una API key de Gemini de pago. Los usuarios de Google AI Pro, Ultra y los individuales gratuitos pasaron a Antigravity CLI el 18 de junio de 2026.

Antigravity CLI: guía práctica del agy de Google

Antigravity CLI es el agente de programación de Google para la terminal. Lo instalas con un script, lo arrancas con agy dentro de un proyecto, inicias sesión con tu cuenta de Google y describes la tarea. Lee tus archivos, propone cambios y comandos y, en su modo por defecto, pregunta antes de tocar nada.

Si usabas Gemini CLI con una cuenta personal, aquí es donde has acabado. Google anunció en su blog para desarrolladores el 19 de mayo de 2026 que Gemini CLI dejaría de atender a los suscriptores de Google AI Pro y Ultra y a los usuarios gratuitos de Gemini Code Assist para particulares el 18 de junio de 2026. Esta guía cubre instalación, inicio de sesión, instrucciones del proyecto, modelos y effort, modos y permisos, MCP, comandos clave, la migración desde Gemini CLI y los límites que indica Google. Todo procede de la documentación de Antigravity a noviembre de 2026.

Qué es Antigravity CLI y para quién

Antigravity CLI es el cliente de terminal de Google Antigravity, la plataforma de desarrollo centrada en agentes de Google. Según Google, está escrito en Go y comparte el motor del agente con la app de escritorio Antigravity 2.0, así que las mejoras llegan a ambos. Mantiene las piezas que conocen los usuarios de Gemini CLI: agent skills, hooks, subagentes y extensiones, que ahora se llaman plugins.

Te encaja si:

usabas Gemini CLI con una cuenta personal de Google, Google AI Pro o Ultra;
quieres un agente de programación en la terminal que use modelos Gemini (y, según tu plan, otros);
ya usas Antigravity en el escritorio y quieres el mismo agente por SSH o en scripts.

Los equipos con licencia de Gemini Code Assist Standard o Enterprise, o con una API key de pago, pueden quedarse en Gemini CLI; para eso está nuestra guía de Gemini CLI. Google no esconde la diferencia: su anuncio dice que no habrá paridad de funciones 1:1 desde el primer día.

Instalación

Sistema	Comando
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`

En macOS y Linux el binario queda en ~/.local/bin/agy; en Windows, en AppData\Local\agy\bin. Compruébalo:

agy --version

Inicio de sesión

Entra en tu proyecto y arráncalo:

cd mi-proyecto
agy

La primera vez te pide un esquema de color, un modo de renderizado (Alt-Screen o Inline) y si confías en la carpeta. Después abre el navegador para entrar con tu cuenta de Google. Funcionan las cuentas personales con plan Free, Pro y Ultra; las cuentas de empresa entran por Gemini Enterprise. El token se guarda en el llavero del sistema (Keychain, Secret Service o el Administrador de credenciales de Windows), así que los siguientes arranques no abren el navegador.

Otras opciones:

Por SSH: agy muestra una URL. Ábrela en tu propio equipo, inicia sesión y pega el código en la terminal.
API key de Gemini: pon "modelProvider": "gemini" en ~/.gemini/antigravity-cli/settings.json y exporta GEMINI_API_KEY. Sin ese ajuste, la key sola no hace nada.
Credenciales de Google Cloud: ejecuta gcloud auth application-default login y define AGY_ADC_AUTH=true.

/logout borra el inicio de sesión guardado.

Tu primera tarea

Explica cómo está organizado el módulo de pagos, añade validación de
entrada al endpoint de reembolsos y ejecuta los tests.

Algunos atajos útiles desde el primer día: @ sugiere rutas de archivos, ! al principio del prompt ejecuta un comando de shell y ? muestra la ayuda con los comandos slash. Para scripts, agy -p "resume README.md" ejecuta un solo prompt sin interfaz e imprime la respuesta; añade --output-format json si otro programa la va a leer. agy -i "prompt" abre la interfaz interactiva con un primer prompt.

Instrucciones del proyecto: AGENTS.md o GEMINI.md

Antigravity lee AGENTS.md o GEMINI.md en la carpeta donde lanzas agy y en sus carpetas superiores hasta la raíz del repo. Ambos están siempre activos y no necesitan frontmatter. Las reglas globales van en ~/.gemini/AGENTS.md o ~/.gemini/GEMINI.md. Las reglas se suman, no se sustituyen.

# Proyecto: billing-service

## Comandos
- Instalar: npm ci
- Tests: npm test (ejecútalo antes de dar una tarea por terminada)

## No hagas
- No edites archivos en src/generated.

Para un control más fino, pon archivos Markdown en .agents/rules/. Cada uno necesita frontmatter con un trigger: always_on, model_decision, glob (se activa cuando el agente toca archivos que coinciden) o manual. Si falta el trigger o no es válido, la regla se descarta sin aviso, y la CLI no admite reglas manual porque no tiene menciones de reglas. Mantén los archivos cortos: cada uno se corta a partir de 24.000 bytes y las reglas globales y always_on comparten un presupuesto de 20.000 tokens.

Si Codex u otro agente ya lee tu AGENTS.md, Antigravity usa el mismo archivo. En CLAUDE.md vs AGENTS.md explicamos cómo compartir un solo conjunto de reglas con Claude Code.

Modelos y effort

Eliges el modelo por ejecución con --model (agy models los lista) o dentro de la sesión con /model. La página de modelos de Google muestra modelos Gemini como Gemini 3.8 Flash y Gemini 3.1 Pro junto a modelos de Claude y GPT-OSS; los que veas dependen de tu plan.

El effort define cuánto razona el modelo. /effort abre un selector y guarda tu elección como predeterminada; --effort low solo vale para esa ejecución. Los niveles son low, medium, high, xhigh y max, aunque la mayoría de modelos solo ofrece de low a high y los de presupuesto fijo lo ignoran.

Modos y permisos

Modo	Qué pasa
`default`	Muestra un diff antes de crear o cambiar archivos y pregunta antes de los comandos
`accept-edits`	Aprueba los cambios dentro del workspace, pero sigue preguntando antes de los comandos
`auto`	Aprueba cambios y ejecuta comandos en el sandbox de terminal; las acciones arriesgadas siguen preguntando
`plan`	Analiza y esboza los pasos antes de escribir código

Arranca con --mode=accept-edits (o auto, plan), cambia con Shift+Tab o fija "agentMode" en ~/.gemini/antigravity-cli/settings.json. auto necesita el sandbox y una cuenta personal (v1.3.5+ en macOS y Linux, v1.4.4+ en Windows); las cuentas de empresa no lo tienen. --sandbox ejecuta la sesión dentro del sandbox de terminal.

Las reglas finas viven en el mismo archivo como listas allow, ask y deny, por ejemplo command(git) o mcp(sql/execute_mutation). Deny gana a ask y ask gana a allow. /permissions las edita desde la interfaz. --dangerously-skip-permissions lo aprueba todo; úsalo solo en un entorno desechable. El porqué está en seguridad de los agentes de programación con IA.

Servidores MCP

Los servidores MCP tienen su propio archivo: ~/.gemini/config/mcp_config.json para todos los proyectos y .agents/mcp_config.json para un workspace.

{
  "mcpServers": {
    "local-db": { "command": "node", "args": ["/path/to/server.js"] },
    "docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
  }
}

Los servidores remotos deben usar Streamable HTTP; el antiguo transporte HTTP+SSE y httpUrl no están soportados. /mcp abre un gestor con estado, recarga y logs. Las herramientas que no hayas permitido se ejecutan en modo Ask.

Comandos que conviene conocer

Comando	Qué hace
`/model`, `/effort`	Cambia el modelo y el nivel de razonamiento
`/permissions`	Gestiona las reglas allow, ask y deny
`/config` o `/settings`	Abre los ajustes
`/mcp`	Gestor de servidores MCP
`/plan`	Investiga, pregunta y redacta un plan revisable
`/resume`	Elige una conversación anterior de esta carpeta
`/rewind`, `/undo`	Retrocede en la conversación
`/fork`, `/clear`	Bifurca la conversación o empieza de cero
`/usage`, `/credits`	Cuotas de modelos y créditos de IA
`/plugin`	Instala, activa o lista plugins

Desde la shell, agy -c continúa la última conversación de la carpeta y --conversation <id> abre una concreta. --add-dir añade otra carpeta al workspace.

Migrar desde Gemini CLI

La primera vez que ejecutas agy en un equipo con configuración de Gemini CLI, una lista te pregunta qué migrar: extensiones, configuración global, tokens de sesión y ajustes visuales. Según la guía de migración de Google:

Sin cambios: GEMINI.md y AGENTS.md del proyecto, ~/.gemini/GEMINI.md y los skills globales de ~/.gemini/skills/.
Se convierte: las extensiones pasan a ser plugins con agy plugin import gemini, y sus comandos, skills.
A mano: los skills del workspace, de .gemini/skills/ a .agents/skills/; los servidores MCP, de ~/.gemini/settings.json a mcp_config.json, cambiando url o httpUrl por serverUrl.
Sin garantía: algunos temas personalizados y capas visuales.
Opciones: --approval-mode desaparece; usa --mode. No hay modo yolo.

Límites y precio

La página de planes de Google incluye la CLI en todos los planes y describe las cuotas sin cifras: Ultra tiene la cuota más alta, renovada cada cinco horas; Pro, una cuota alta renovada cada cinco horas hasta un límite semanal; los demás planes, una cuota que se renueva cada semana. Los límites dependen del trabajo que hace el agente. En Pro y Ultra, los créditos de IA pueden cubrir el uso por encima de la cuota al precio de consumo de Gemini Enterprise, y un ajuste permite desactivarlo. /usage y /credits te dicen cómo vas.

Junto a Claude Code y Codex

Antigravity suele ser uno de varios agentes. Algunas costumbres ayudan:

Un solo archivo de reglas. Antigravity y Codex leen AGENTS.md; Claude Code lee CLAUDE.md, que puede apuntar a él.
Un worktree por agente. Da a cada agente su propio git worktree para que no editen los mismos archivos.
Los mismos servidores MCP en todas partes. Cada herramienta tiene su propia configuración, así que el mismo servidor se añade tres veces.

Nosotros desarrollamos AgentVera, una app de escritorio para macOS, Windows y Linux que ejecuta Antigravity CLI junto a Claude Code, Codex, Gemini CLI y otros agentes, cada uno en una terminal real con tu propia instalación y tu sesión. Para Antigravity en concreto (detalles):

Espacio de trabajo: Antigravity es una casilla en la cuadrícula de agentes de cada proyecto y vuelve a su conversación al reabrir la app.
Permisos: Preguntar, Auto (--mode=accept-edits) o Acceso total (--dangerously-skip-permissions) por agente.
Modelo y effort: elige modelo y effort low, medium o high al crear el agente.
Instrucciones: agy no tiene opción para instrucciones extra, así que las reglas van en AGENTS.md o GEMINI.md.
Gestor de MCP: los servidores que configuras una vez se añaden a Antigravity al arrancar, junto a tu propio mcp_config.json.
Worktrees: crea uno desde el panel de Git y arranca Antigravity en él, con Claude Code en otro.

La cuadrícula, los worktrees, la revisión de código y el gestor de MCP están en el plan gratuito. Para comparar los agentes de Google con los de Anthropic, lee Gemini CLI vs Claude Code, o descarga AgentVera.

En resumen

Instala con el script, ejecuta agy, entra con Google y conserva tu AGENTS.md o GEMINI.md. Mueve los servidores MCP a mcp_config.json, importa las extensiones con agy plugin import gemini, empieza en modo default o accept-edits y revisa /usage antes de las sesiones largas.