Google Antigravity CLI: comandos, configuración y permisos

La CLI de Google Antigravity (agy) ejecuta el agente de programación de Antigravity en su terminal. Puede configurarlo mediante comandos slash como /config, /permissions y /hooks, o en sus archivos settings.json y hooks.json. El modo de ejecución, el ajuste toolPermission y las reglas allow, ask y deny determinan qué puede hacer el agente sin solicitar su confirmación.

Configurar la CLI de Antigravity con /config y settings.json

La CLI guarda las preferencias persistentes en ~/.gemini/antigravity-cli/settings.json. Solo almacena los valores que difieren de los predeterminados.

{
  "agentMode": "accept-edits",
  "toolPermission": "strict",
  "notifications": true
}

Cómo funciona el archivo de configuración:

• Guardado: /config, /model, /effort, /statusline, /title y /permissions escriben directamente en el archivo. Lo mismo ocurre al seleccionar permitir siempre o denegar siempre ante una solicitud de permisos. Restablecer una opción a su valor por defecto elimina su clave, y únicamente su usuario del sistema puede leer el archivo (0600).
• Ayuda del editor: una clave $schema al inicio del archivo proporciona autocompletado y validación en editores como VS Code e IDEs de JetBrains. La CLI mantiene la clave al guardar.
• Panel de ajustes: escriba /config (o /settings) y pulse Enter. Comience a escribir para filtrar la lista, cambie los valores con las teclas de flecha o Enter, y pulse Esc para cerrar.
• Opciones de una sola sesión: opciones como agy --sandbox --model="Gemini 3.8 Flash" solo afectan a la sesión actual y no se guardan en el archivo.
• Archivos dañados: si settings.json contiene un valor no válido o un JSON incorrecto, se muestra una pantalla de Settings Error. Puede salir y corregirlo a mano, continuar con los valores predeterminados durante esta sesión, o sobrescribir el archivo con los valores predeterminados. Al sobrescribir se genera una copia de seguridad como settings.json.corrupted.<timestamp> y se restablecen todas las opciones, incluidas las reglas de permisos.

Otros ajustes residen en sus propios archivos:

• Atajos de teclado: ~/.gemini/antigravity-cli/keybindings.json, abierto mediante /keybindings. Cada acción se asigna a una lista de teclas. Una lista vacía ([]) desactiva el atajo, salvo las acciones protegidas cli.exit y cli.enter.
• Servidores MCP: ~/.gemini/config/mcp_config.json para todos los espacios de trabajo o <workspace>/.agents/mcp_config.json para uno específico, administrados con /mcp.
• Hooks: ~/.gemini/config/hooks.json a nivel global o <workspace>/.agents/hooks.json por espacio de trabajo, gestionados con /hooks. Los hooks definidos en settings.json no se cargan.
• Complementos: ~/.gemini/config/plugins/<plugin>/ o <workspace>/.agents/plugins/<plugin>/, cada uno con un manifiesto opcional plugin.json.

Modos de ejecución y permisos de herramientas

Dos parámetros determinan la frecuencia con la que el agente se detiene a consultarle: el modo de ejecución y toolPermission. Las reglas de denegación (deny) continúan bloqueando acciones en cualquier modo.

Establezca el modo con agentMode en settings.json, para una sola sesión con --mode, o alterne entre modos con Shift + Tab:

• default (dejando agentMode sin definir): le solicita revisar los diffs antes de modificar cualquier archivo.
• accept-edits: aprueba automáticamente la creación y edición de archivos dentro del espacio de trabajo.
• auto (Preview): aprueba automáticamente ediciones y comandos seguros, ejecuta por defecto los comandos de terminal dentro del sandbox de terminal, y pausa los comandos de riesgo para solicitar aprobación. Requiere la versión 1.3.5 o superior en macOS y Linux, o la versión 1.4.4 o superior en Windows. No está disponible para cuentas empresariales o corporativas.
• plan: añade /plan para que el agente examine la base de código y esboce un plan antes de editar.

toolPermission establece cuándo solicita permiso el agente antes de ejecutar una herramienta:

• request-review (predeterminado): solicita confirmación antes de ejecutar herramientas de escritura, bash, web o MCP.
• proceed-in-sandbox: ejecuta comandos de terminal sin preguntar cuando Sandbox Mode está activo y el comando corre en el sandbox de terminal.
• strict: solicita confirmación ante cada acción de herramienta, incluidas las lecturas de archivos. Prevalece sobre el modo auto.
• always-proceed: ejecuta comandos de terminal, solicitudes web y herramientas MCP sin preguntar, salvo acciones que coincidan con una regla ask o deny. También prevalece sobre el modo auto.

Reglas de permisos: allow, ask y deny

Las reglas usan la estructura action(target) en las listas allow, ask y deny bajo permissions en settings.json. Estas listas residen en su archivo de configuración global. Los conflictos se resuelven con un orden estricto: Deny primero, luego Ask y finalmente Allow. Así, con command(*) en ask y command(git) en allow, cada comando seguirá requiriendo confirmación.

Comportamiento de las reglas:

• Comodines y patrones: * coincide con cualquier destino de una acción, como mcp(*). Las reglas command coinciden por prefijo, palabra por palabra. Inicie el destino con regex: para usar una expresión regular. Los dominios también coinciden con sus subdominios.
• Reglas implícitas: permitir write_file en una ruta permite también read_file en ella. Denegar read_file en una ruta bloquea también write_file.
• Rutas de Windows: las letras de unidad como C: se eliminan y las barras invertidas pasan a ser barras inclinadas antes de comprobar las reglas.
• Modificación en el aviso: cuando aparece un aviso ask para un archivo, URL o herramienta MCP, puede ampliar el destino, como de un archivo a su carpeta contenedora, antes de autorizarlo. Esto no funciona en comandos de terminal.

Notificaciones y hooks

El ajuste notifications está desactivado por defecto. Al activarlo, la CLI hace sonar la campana del terminal y muestra una notificación de escritorio cuando el agente necesita aprobación o respuesta, o al finalizar su turno.

Los hooks ejecutan sus propios comandos de shell en puntos determinados del ciclo del agente. Escriba /hooks para consultar los activos:

Cada hook recibe JSON por stdin con campos como conversationId, workspacePaths, transcriptPath y modelName, y responde con JSON por stdout. Un hook PreToolUse puede devolver una decision entre allow, auto_approve, deny, ask, force_ask o deny_unless_prior_grant. Un hook Stop que devuelve "decision": "continue" mantiene al agente en funcionamiento.

Para gestionar subagentes en segundo plano con /agents, saltar a subagentes en espera y aprobarlos con Alt+J y Ctrl+K, y coordinar equipos multiagente con /teamwork, consulte Google Antigravity multi-agent: run parallel coding agents.

Si también utiliza el editor independiente, consulte Google Antigravity IDE: editor, agents and permissions para ver cómo comparte hooks globales y configura el modo Strict, el aislamiento de terminal y las revisiones de artefactos.

Para conectar bases de datos, documentación y APIs externas con /mcp o mcp_config.json, consulte Google Antigravity MCP servers: set up and manage tools.

Para instalar la CLI en PowerShell o el Símbolo del sistema, configurar su PATH en Windows y habilitar el sandbox AppContainer, consulte Google Antigravity on Windows: install, CLI and setup.

Supervisar sesiones de Antigravity en un teclado o móvil con Orbtile

Orbtile muestra sus agentes de programación en un Logitech MX Creative Keypad, un iPhone o un teléfono Android (Android 8.0 o posterior) con Orbtile Mobile. Funciona en ordenadores con macOS 14.0 Sonoma o posterior con Apple silicon, o Windows 11 (x64).

• Aplicación de escritorio de Antigravity: Orbtile monitoriza las conversaciones de la aplicación de escritorio de Antigravity. Cada una dispone de una tecla con su título, estado y texto de respuesta en directo, y una conversación que aguarda respuesta pasa al frente. Puede responder preguntas con opciones numeradas directamente desde el teclado, hasta cuatro preguntas con dos a cuatro opciones cada una. Las solicitudes de permisos y respuestas escritas se realizan en su ordenador.
• CLI de Antigravity: las sesiones de la CLI y del IDE no aparecen automáticamente. Como los hooks de la CLI reciben el conversationId en formato JSON, un script de hook puede informar cada sesión a la Adapter API local de Orbtile. Active la Adapter API en Settings > Agents y autorice su adaptador. Puede notificar si la sesión está pensando, ejecutando una herramienta, escribiendo, inactiva, esperando datos o en error.
• Todos los agentes en un único panel: el mismo teclado o teléfono muestra sesiones de Claude Code, Codex, ZCode y Kimi Code, además de sesiones remotas por SSH. Consulte Notificaciones de Antigravity: sepa cuándo un agente está esperando y Show any script or agent on a keypad with the Orbtile Adapter API.