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

URL: https://agentvera.dev/es/blog/how-to-use-antigravity-cli/ · Publicado: 2026-11-05

Guía de Antigravity CLI: instala agy, inicia sesión, escribe AGENTS.md, elige modelo y effort, configura modos, permisos y MCP y migra desde Gemini CLI.

**En resumen:**

- Antigravity CLI (agy) es el agente de terminal de Google que sustituyó a Gemini CLI para Google AI Pro, Ultra y los usuarios individuales gratuitos el 18 de junio de 2026.
- Se instala con un script, se lanza con agy dentro del proyecto y se entra con tu cuenta de Google; las reglas siguen en AGENTS.md o GEMINI.md, que lee sin cambios.
- Los servidores MCP pasan de settings.json a mcp_config.json, las extensiones se convierten en plugins con agy plugin import gemini y --mode reemplaza a --approval-mode.

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](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ "Transición de Gemini CLI a Antigravity CLI") 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](https://antigravity.google/docs/getting-started?tab=cli "Inicio rápido 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](/es/glossary/coding-agent/ "Qué es 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](/es/blog/how-to-use-gemini-cli/ "Cómo usar 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:

```bash
agy --version
```

## Inicio de sesión

Entra en tu proyecto y arráncalo:

```bash
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

```text
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.

```markdown
# 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](/es/blog/claude-md-agents-md/ "CLAUDE.md y 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](/es/blog/ai-coding-agent-security/ "Seguridad de los agentes de IA").

## Servidores MCP

Los servidores [MCP](/es/glossary/mcp/ "Qué es MCP") tienen su propio archivo: `~/.gemini/config/mcp_config.json` para todos los proyectos y `.agents/mcp_config.json` para un workspace.

```json
{
  "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](https://antigravity.google/docs/cli/gcli-migration "Migración desde Gemini CLI") 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](https://antigravity.google/docs/plans "Planes de Antigravity") 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](/es/blog/git-worktree-parallel-agents/ "Git worktrees para agentes en paralelo") 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](/es/agents/antigravity/ "Antigravity en AgentVera")):

- **[Espacio de trabajo](/es/features/workspace/ "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](/es/features/mcp-manager/ "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](/es/features/git-and-github/ "Git y GitHub") 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](/es/blog/gemini-cli-vs-claude-code/ "Gemini CLI vs Claude Code"), o [descarga AgentVera](/es/download/ "Descargar 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.

## Preguntas frecuentes

**¿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.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/