Hoja de trucos de Google Antigravity CLI (agy): Comandos y configuración

Antigravity CLI (agy) es el agente de programación ligero y nativo en terminal de Google, escrito en Go dentro de la plataforma Antigravity 2.0. Diseñado para ejecución paralela de subagentes, aislamiento con Git worktree, Agent Skills, plugins e integraciones MCP, agy reemplaza al antiguo cliente de consumo Gemini CLI.

Esta hoja de trucos cubre banderas y subcomandos de agy CLI, comandos slash interactivos, atajos de teclado, configuración de .agents/ y mcp_config.json y pasos de migración desde Gemini CLI.

🔗 Hojas de trucos relacionadas: Comparativa de CLIs de agentes de programación en terminal · Hoja de trucos de Claude Code CLI · Hoja de trucos de OpenAI Codex CLI · Arquitectura de habilidades para agentes de IA (Skills)

1. Instalación, subcomandos y banderas de inicio

1.1 Instalación y lanzamiento

# Instalar Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Iniciar TUI interactiva (sigue las indicaciones de autenticación en el primer inicio)
agy

1.2 Subcomandos principales y banderas de inicio

Comando / Bandera	Descripción	Ejemplo de uso
`agy`	Inicia la TUI interactiva en el espacio de trabajo activo	`agy`
`agy -p "<prompt>"`	Ejecución no interactiva (headless), imprime en stdout y sale	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Inicia una sesión interactiva precargada con un prompt inicial	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Reanuda la sesión de conversación más reciente	`agy -c`
`agy --conversation <id>`	Carga una conversación histórica específica por su ID	`agy --conversation 42a506e6-...`
`--mode <mode>`	Define el modo de permisos de ejecución: `default` · `accept-edits` · `auto` (aprobación automática en sandbox) · `plan`	`agy --mode accept-edits`
`--model <model>`	Sobrescribe el modelo activo para esta sesión	`agy --model gemini-3.8-flash`
`--effort <level>`	Ajusta el esfuerzo de razonamiento (`low` a `max`, según modelo)	`agy --effort high`
`--agent <agent>`	Adjunta un perfil de agente personalizado al arrancar	`agy --agent reviewer`
`--add-dir <path>`	Concede acceso de contexto a un directorio adicional (repetible)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Lista los modelos disponibles o agentes personalizados configurados	`agy models`
`agy plugin <subcmd>`	Gestiona plugins: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Comandos slash interactivos en TUI

Escribe / dentro de agy para invocar y autocompletar los comandos integrados:

2.1 Control general, de sesión y de historial

Comando	Función	Notas y uso
`?` / `/help`	Lista todos los comandos slash y atajos disponibles	Referencia rápida dentro de la sesión
`/config` / `/settings`	Abre la vista interactiva de configuración a pantalla completa	Edita preferencias, temas y permisos (`settings.json`)
`/clear`	Limpia el búfer del prompt activo y abre una sesión nueva	Cambia limpiamente a otra tarea no relacionada
`/compact`	Comprime y resume el historial de conversación	Recupera espacio de contexto en ejecuciones largas
`/resume`	Abre el selector de conversaciones para restaurar sesiones	Continúa flujos de trabajo interrumpidos
`/rewind` / `/undo`	Retrocede paso a paso por los turnos de la conversación	Revierte turnos o rumbos incorrectos
`/fork`	Bifurca la conversación en el punto de control actual	Explora ramas paralelas del workspace sin riesgo
`/exit` / `/quit`	Sale de la sesión de `agy` CLI	O pulsa `Ctrl + D Ctrl + D`

2.2 Modelos, flujos de trabajo, agentes y extensiones

Comando	Función	Notas y uso
`/model`	Cambia el modelo de IA activo en mitad de la sesión	Equilibra velocidad/costo frente a capacidad de razonamiento
`/effort`	Consulta o ajusta el esfuerzo de razonamiento (`low` a `max`)	Nota: `agy -p "/effort"` devuelve salida JSON de solo lectura
`/plan`	Genera un plan paso a paso antes de modificar archivos	Barrera de seguridad previa a grandes cambios de arquitectura
`/goal`	Ejecuta de forma autónoma hasta completar sin pausas intermedias	Ideal para tareas de largo horizonte
`/grill-me`	Realiza una entrevista interactiva de requisitos antes de programar	Aclara casos límite y criterios de aceptación por adelantado
`/agent`	Cambia o invoca perfiles de subagentes/agentes personalizados	Carga definiciones desde `.agents/agents/`
`/worktree`	Crea o gestiona directorios Git worktree aislados	Trabaja en ramas paralelas sin ensuciar el árbol principal
`/mcp`	Inspecciona estado en vivo, logs y recarga la configuración MCP	Diagnostica servidores MCP locales o remotos
`/plugin`	Explora, activa, desactiva o inspecciona plugins del Marketplace	Gestiona skills, reglas, hooks y servidores MCP empaquetados
`/voice`	Alterna el modo de dictado por voz	Atajo equivalente: `F5`

3. Atajos de terminal y sintaxis de entrada

Atajo / Sintaxis	Acción	Efecto y escenario
`@<path>`	Autocompletado de rutas	Inyecta rutas concretas de archivos o carpetas en el contexto
`!<command>`	Ejecución en línea en terminal	Antepón `!` para ejecutar comandos shell directamente (p. ej., `!npm run build`)
`Ctrl + G`	Abrir editor externo	Redacta prompts largos o multilínea en tu editor predeterminado (Vim, VS Code)
`Esc Esc`	Vaciar caja de prompt activa	Borra la entrada pendiente cuando no hay streaming activo
`F5`	Alternar dictado por voz	Equivalente a `/voice`
`Ctrl + D Ctrl + D`	Salir de la sesión	Pulsa dos veces `Ctrl + D` para salir limpiamente

4. Jerarquía de configuración y `mcp_config.json`

4.1 Mapa de directorios globales frente a workspace

Capa	Ámbito global (todos los workspaces)	Ámbito de workspace (local al proyecto)	Propósito
Configuración CLI	`~/.gemini/antigravity-cli/settings.json`	—	Preferencias CLI, tema, editor y permisos predeterminados
Atajos de teclado	`~/.gemini/antigravity-cli/keybindings.json`	—	Mapeos de teclado personalizados para la terminal
Instrucciones del proyecto	`~/.gemini/AGENTS.md` o `GEMINI.md`	`./AGENTS.md` o `./GEMINI.md`	Convenciones persistentes del repo, comandos de build/test y rol
Reglas permanentes	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Restricciones de fondo inyectadas automáticamente al contexto
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Paquetes modulares de Agent Skills con scripts y recursos
Configuración MCP	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Definiciones de servidores MCP locales stdio y remotos HTTP

⚠️ Esquema incompatible para MCP remoto (serverUrl): En mcp_config.json, los servidores MCP HTTP remotos deben usar serverUrl en lugar de las claves heredadas url o httpUrl; usar url provoca fallos silenciosos de conexión.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. Migración desde el antiguo Gemini CLI a `agy`

El nivel gratuito de consumo y las solicitudes de Google AI Pro/Ultra en Gemini CLI finalizaron el 18 de junio de 2026 (quedando únicamente Gemini Code Assist empresarial y flujos medidos por clave API). Equivalencias clave de migración hacia agy:

Componente	Antiguo Gemini CLI	Antigravity CLI (`agy`)	Acción de migración
Entorno y binario	TypeScript de código abierto (`gemini`)	CLI multiagente en Go (`agy`)	Cambia las invocaciones a `agy`; la bienvenida automática corre al iniciar
Extensiones	Extensiones de Gemini CLI	Plugins nativos de Antigravity	Ejecuta `agy plugin import gemini` para convertir e importar
Archivos de instrucciones	`GEMINI.md`	`GEMINI.md` y `AGENTS.md`	Totalmente compatible: tu `GEMINI.md` actual funciona tal cual
Ruta local de skills	`.gemini/skills/`	`.agents/skills/`	Mueve las carpetas de skills a `.agents/skills/<name>/SKILL.md`
Workflows heredados	`.agents/workflows/`	Migrados a Agent Skills	Convierte flujos de archivo único a `.agents/skills/` (`/migrate-workflows`)
Config y claves MCP	En línea en `settings.json` con `url`	`mcp_config.json` dedicado usando `serverUrl`	Separa los bloques MCP a `mcp_config.json` y renombra `url` a `serverUrl`