🛰️ Antigravity CLI — La Terminal de Google para Agentes (agy)

Qué es y por qué existe

Antigravity CLI es la superficie terminal-first de Google Antigravity: el mismo agent harness que la app y el IDE, pero en una TUI ligera que se lanza con agy.

Lanzamiento: 19-may-2026 (blog oficial) · versión actual: 1.4.9 (28-oct-2026).

Modelos: Gemini 4 Argon, Gemini 3.8 Flash, Claude Sonnet/Opus 5.5 y GPT-OSS 120B, según plan.

Gratis: el plan $0 incluye la CLI y Gemini 3.8 Flash con cuota semanal.

Idea: invocar, monitorizar y orquestar agentes sin salir de la terminal, con el mismo estado que Antigravity 2.0.

No confundir las superficies

Antigravity App (2.0), Antigravity IDE, Antigravity CLI (agy), Extensions y SDK comparten harness y ajustes, pero son productos distintos. Esta nota es solo de la CLI.

🧭 Dónde encaja

flowchart LR
    H["🧠 Antigravity Agent Harness<br/>(común)"]
    H --> APP["🖥️ Antigravity 2.0<br/>GUI de control"]
    H --> IDE["💻 Antigravity IDE<br/>editor completo"]
    H --> CLI["⌨️ Antigravity CLI (agy)<br/>TUI ligera"]
    H --> SDK["🐍 Antigravity SDK<br/>agentes en Python"]
    CLI -. "@conversation" .-> APP
    CLI -. "settings compartidos" .-> IDE

Lo importante: no es un producto aparte con otro cerebro. Un cambio en el harness llega a todas las superficies. Y los settings y permisos se comparten, así que configurar la CLI también afecta a la app.

Relación con Gemini CLI

Google ofrece migración automática desde Gemini CLI en el primer arranque, y conversión de extensiones:

agy plugin import gemini

Se conservan skills, rules y servidores MCP; algunos temas visuales y overlays experimentales no. La CLI hereda conceptos de Gemini CLI, pero es un producto nuevo.

💾 Instalación

macOS, Linux y Googlebook

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

Binario por defecto: ~/.local/bin/agy.

Windows

irm https://antigravity.google/cli/install.ps1 | iex

Ruta por defecto: C:\Users\<usuario>\AppData\Local\agy\bin.

Verificar y arrancar

agy --version
agy

En el primer arranque la TUI pide tres cosas:

Paso	Opciones
Color scheme	Dark · Solarized Dark · Solarized Light · terminal
Rendering mode	Alt-Screen (pantalla completa) o Inline (historial secuencial)
Workspace trust	Confirmar que confías en el repositorio

Requisitos

Los requisitos de glibc ≥ 2.28 y glibcxx ≥ 3.4.25 (Ubuntu 20+, Debian 10+, Fedora 36+, RHEL 8+) son de la app de escritorio, no de la CLI. La app pide además macOS 12+ o Windows 10/11.

🧠 Modelos y planes

Antigravity da acceso a modelos de Google DeepMind y de terceros, con niveles de razonamiento Low / Medium / High:

Modelo	Free / AI Plus	AI Pro	AI Ultra	Enterprise
Gemini 4 Argon	❌	✅ †	✅	✅
Gemini 3.8 Flash	✅	✅	✅	✅
Gemini 3.7 Flash	❌	❌	❌	✅
Gemini 3.6 Flash	❌	❌	❌	✅
Gemini 3.1 Pro	❌	❌	❌	✅
Claude Sonnet 5.5 (thinking)	❌	✅ ‡	✅	✅
Claude Opus 5.5 (thinking)	❌	✅ ‡	✅	✅
Claude Sonnet 4.6	✅ *	✅ *	❌	❌
Claude Opus 4.6	✅ *	✅ *	❌	❌
GPT-OSS 120B	✅ *	✅ *	✅ *	❌

Fechas que importan

† Gemini 4 Argon requiere Google AI Pro de pago o trial con dispositivos premium elegibles.

‡ Claude 5.5 solo en Pro no-trial.

* Claude 4.6 y GPT-OSS 120B se retiran el 2-nov-2026.

Si tu flujo depende de Claude o GPT dentro de Antigravity, tienes días, no meses.

Planes

Plan	Precio	Qué incluye
Free	$0/mes	Modelos variados, cuota semanal básica, CLI incluida
Google AI Pro	Suscripción	Más cuota, pool de AI credits, Gemini 4 Argon y Claude 5.5
Google AI Ultra	Suscripción	Cuota máxima cada 5 h, límites semanales altos, terceros
Business / Enterprise	Vía Google Cloud	Gemini Enterprise, controles admin, spend caps

Sin BYOK

Antigravity no soporta bring-your-own-key ni bring-your-own-endpoint. Pagas cuota o créditos de Google; no puedes meter tu clave de otro proveedor para saltarte límites.

⌨️ Slash commands

Escribe / en el prompt para abrir el menú. Los que más se usan:

Comando	Qué hace
`/agents`	Panel de agentes: cambiar agente y monitorizar subagentes
`/plan <tarea>`	Explorar, aclarar y generar un Implementation Plan revisable
`/goal <objetivo>`	Correr en autónomo hasta verificar que el objetivo está completo
`/boost <tarea>`	Bucles de razonamiento multi-agente bajo demanda
`/grill-me [tarea]`	El agente te entrevista antes de empezar
`/teamwork-preview <tarea>`	Equipos multi-agente colaborativos (planes pagos)
`/browser <tarea>`	Delegar navegación y verificación UI al subagente browser
`/schedule <cuándo> <tarea>`	Timer one-shot o cron recurrente
`/context`	Visualizar uso de contexto
`/diff`	Visor interactivo de cambios, turnos y commits
`/rewind` · `/fork`	Deshacer historial · bifurcar la conversación
`/resume` · `/rename`	Recuperar o renombrar sesiones
`/model` · `/effort`	Cambiar modelo o nivel de razonamiento
`/permissions` · `/config`	Permisos y ajustes
`/mcp` · `/skills` · `/hooks` · `/plugin`	Extensiones
`/learn [instrucción]`	Convertir correcciones de sesión en rules o skills
`/usage` · `/credits`	Cuotas por modelo y créditos
`/voice`	Dictado por micrófono (o `F5`)

Atajos que ahorran tiempo

Tecla	Acción
`Shift+Tab`	Ciclar modo: `default` → `accept-edits` → `auto` → `plan`
`Ctrl+K`	Aprobar la acción pendiente del subagente
`Alt+J`	Saltar al siguiente subagente que espera confirmación
`Ctrl+O`	Expandir/colapsar el razonamiento de tools
`Ctrl+V`	Pegar imagen o vídeo en el prompt
`Ctrl+G`	Editar el prompt en `$EDITOR`
`@`	Autocompletar rutas del workspace
`!`	Ejecutar un comando de terminal directo
`esc esc`	Limpiar el prompt
`?`	Ayuda con todos los comandos

🛡️ Modos de ejecución y permisos

Modo	Comportamiento	Cuándo
default	Diff interactivo antes de escribir; pregunta antes de comandos	Trabajo normal y código sensible
accept-edits	Aprueba ediciones dentro del workspace; sigue preguntando comandos	Prototipado en código de confianza
auto (Preview)	Edita, ejecuta en sandbox y evalúa comandos fuera de él	Flujos autónomos; requiere sandbox
plan	Investiga y propone plan antes de tocar código	Arquitectura desconocida

auto requiere v1.3.5+ en macOS/Linux y v1.4.4+ en Windows, y no está disponible en cuentas business/enterprise.

Presets de permisos

En ~/.gemini/antigravity-cli/settings.json:

{
  "toolPermission": "proceed-in-sandbox",
  "enableTerminalSandbox": true
}

Preset	Qué permite
`request-review`	Pregunta por escrituras, bash, red y MCP (default)
`proceed-in-sandbox`	Comandos seguros dentro del sandbox sin preguntar
`always-proceed`	Todo sin preguntar salvo reglas `ask`/`deny`
`strict`	Pregunta todo, incluso lecturas

--dangerously-skip-permissions

Autoaprueba todas las tools. Úsalo solo en contenedores desechables, nunca en tu máquina con credenciales reales.

🧩 Extensibilidad: el mismo modelo que Claude Code

Antigravity usa el estándar abierto de Agent Skills y un sistema de capas muy parecido al de Claude Code:

Pieza	Ruta workspace	Ruta global	Para qué
Skills	`.agents/skills/<name>/SKILL.md`	`~/.gemini/antigravity-cli/skills/`	Procedimientos reutilizables
Rules	`AGENTS.md`, `GEMINI.md`, `.agents/rules/*.md`	`~/.gemini/AGENTS.md`, `~/.gemini/config/rules/`	Invariantes y estilo
Subagents	`.agents/agents/<name>.md`	`~/.gemini/config/agents/`	Roles con tools y modelo propios
Hooks	`.agents/hooks.json`	`~/.gemini/config/hooks.json`	Scripts en el ciclo de vida
MCP	`.agents/mcp_config.json`	`~/.gemini/config/mcp_config.json`	Herramientas externas
Plugins	`plugins/<name>/`	Marketplace	Paquetes distribuibles

Reglas: lo que sí funciona

AGENTS.md y GEMINI.md se cargan siempre en su ámbito, sin frontmatter.
Los .md dentro de .agents/rules/ exigen frontmatter con trigger: always_on | model_decision | glob | manual.
Si el trigger está mal escrito (alwaysOn, modelDecision), la regla se descarta en silencio.
Las reglas son acumulativas: la más específica gana.

Subagentes

Los built-in son research, browser y self. Los custom se definen en markdown con frontmatter:

---
name: security-reviewer
description: Revisa diffs en busca de vulnerabilidades y propone parches.
tools: [view_file, grep_search, run_command]
model: pro
commandExecutionPolicy: sandbox
---

model acepta inherit, flash o pro. El subagente no hereda la conversación: empieza con contexto limpio.

🤖 Headless: agentes dentro de scripts

# Texto plano
agy -p "Resume este diff en tres bullets"
 
# JSON con métricas
agy -p "¿Qué hace git bisect?" --output-format json | jq
 
# Streaming NDJSON
agy -p "Audita este repo" --output-format stream-json
 
# Salida estructurada validada
agy -p "Extrae los endpoints" --json-schema ./schema.json

Flag	Para qué
`-p`, `--print`, `--prompt`	Un prompt y salir
`--output-format`	`text` · `json` · `stream-json`
`--input-format`	`text` · `stream-json`
`--json-schema`	Fuerza salida válida contra un schema
`--print-timeout`	Límite de tiempo (`0` = esperar)
`--model` · `--effort` · `--agent`	Overrides por sesión
`--sandbox`	Aislamiento del terminal
`--mode`	`accept-edits` · `auto` · `plan`

Uso típico en CI
agy -p "Ejecuta los tests y explica los fallos" \
  --output-format json \
  --print-timeout 10m > result.json
En CI sin terminal, autentica antes de forma interactiva. Si no hay credenciales, sale con authentication required en vez de colgarse.

⚙️ Configuración

Archivo	Ruta
Settings	`~/.gemini/antigravity-cli/settings.json`
Keybindings	`~/.gemini/antigravity-cli/keybindings.json`
Hooks	`.agents/hooks.json` o `~/.gemini/config/hooks.json`

{
  "$schema": "https://antigravity.google/schemas/v1/settings.json",
  "agentMode": "auto",
  "colorScheme": "tokyo night",
  "toolPermission": "proceed-in-sandbox",
  "enableTerminalSandbox": true,
  "useG1Credits": false,
  "verbosity": "medium"
}

useG1Credits: false evita que consuma créditos cuando se agota la cuota del plan. Si lo pones en true, sigue gastando dinero real.

📊 Antigravity CLI vs Claude Code vs OpenCode

Criterio	Antigravity CLI	Claude Code	OpenCode
Fabricante	Google	Anthropic	OpenCode
Licencia	Propietaria (repo solo issues/ejemplos)	Propietaria	Open source
Modelos	Gemini + Claude + GPT-OSS según plan	Claude	Múltiples proveedores
BYOK	❌	❌ (salvo API)	✅
Gratis	✅ cuota semanal	❌	✅ modelos gratis
Skills	✅ `.agents/skills`	✅ `.claude/skills`	✅
Subagentes	✅ built-in + custom	✅	✅
Hooks	✅ `hooks.json`	✅	✅
Headless	✅ `-p` + JSON schema	✅	✅
Fuerte	Integración Google, harness único	Madurez y ecosistema	Libertad de modelo

Lo que esto significa para ti

Ya tienes OpenCode y una nota comparativa con Antigravity. La CLI de Google aporta Gemini 4 Argon sin API key y una TUI muy pulida; OpenCode aporta libertad de proveedor. No son excluyentes: pueden convivir con el mismo repo y distintas reglas.

⚖️ Lectura crítica

Lo bueno:

TUI rápida y ligera, con muy buen manejo de subagentes (Ctrl+K, Alt+J) y diffs.
Harness compartido con la app y el IDE: no hay que reconfigurar permisos ni skills.
Estándar abierto en skills y reglas (AGENTS.md, .agents/), portable a otros agentes.
Headless serio: JSON, NDJSON y validación por schema, no solo -p.
Migración desde Gemini CLI integrada, con conversión de extensiones a plugins.

Lo que hay que tener en cuenta:

Nombres confusos: Antigravity App, IDE, CLI, Extensions y SDK. Cinco productos, un artículo.
Cuota, no tokens: no sabes cuánto te queda hasta que lo gastas. /usage y /credits ayudan, pero el cálculo es opaco.
Sin BYOK: si se acaba la cuota, o pagas créditos o esperas.
Modelos de terceros en retirada: Claude 4.6 y GPT-OSS salen el 2-nov-2026. La parrilla cambia rápido.
Repo sin código ni licencia: 2.660 ⭐ y 795 issues abiertos, pero es un canal de soporte, no un proyecto open source.
auto no es universal: exige sandbox, versión mínima y no existe en business/enterprise.
Documentación versionada a medias: la guía dice v1.2+ mientras la release actual es 1.4.9; algunas funciones dependen de la versión y del sistema.

La lectura de fondo

Google está consolidando un solo harness para todos sus productos de desarrollo. Antigravity CLI no es «otra CLI más»: es la apuesta de que el agente vive en la terminal y la GUI es solo una vista. Si esa tesis se cumple, aprender agy ahora vale más que esperar.

🔗 Enlaces

🔗 Notas relacionadas

⚡ OpenCode 2.0 vs Antigravity CLI — comparativa previa y sinergia entre ambos.
🛰️ Antigravity CLI Docs en Español — tu portal de documentación en español.
🧠 Claude Code Best Practices — el equivalente en el ecosistema Anthropic.
🧠 Gemini 4 Argon — el modelo tope disponible en Antigravity.
Hive — alternativa de API barata para DeepSeek.
📥 Vault Ingest — cómo se guardó esta nota.

⚡ Ryukami Labs

Explorador

🛰️ Antigravity CLI — La Terminal de Google para Agentes (agy)

🛰️ Antigravity CLI — La Terminal de Google para Agentes (agy)

🧭 Dónde encaja

Relación con Gemini CLI

💾 Instalación

macOS, Linux y Googlebook

Windows

Verificar y arrancar

🧠 Modelos y planes

Planes

⌨️ Slash commands

Atajos que ahorran tiempo

🛡️ Modos de ejecución y permisos

Presets de permisos

🧩 Extensibilidad: el mismo modelo que Claude Code

Reglas: lo que sí funciona

Subagentes

🤖 Headless: agentes dentro de scripts

⚙️ Configuración

📊 Antigravity CLI vs Claude Code vs OpenCode

⚖️ Lectura crítica

🔗 Enlaces

🔗 Notas relacionadas

Vista Gráfica

Tabla de Contenidos

Retroenlaces