Antigravity CLI (agy): configuración y permitir todos los permisos

La CLI de Google Antigravity (agy) ejecuta el agente de programación de Antigravity en su terminal en macOS, Linux, Googlebook y Windows. Puede configurarla con comandos slash como /config y /permissions o en ~/.gemini/antigravity-cli/settings.json. Para permitir todos los permisos sin avisos de confirmación, inicie agy --dangerously-skip-permissions, defina "toolPermission": "always-proceed", o añada reglas allow con comodín como command(*).

Instalar e iniciar la CLI de Antigravity (agy)

Instale la CLI de Antigravity (agy, v1.2+) con el instalador correspondiente a su sistema operativo.

En macOS, Linux y Googlebook, ejecute:

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

El instalador coloca el binario en ~/.local/bin/agy de forma predeterminada.

En Windows con PowerShell, ejecute:

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

En Windows con el Símbolo del sistema (CMD), ejecute:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Ambos instaladores de Windows colocan el binario en C:\Users\<username>\AppData\Local\agy\bin por defecto. Abra una terminal y compruebe la instalación:

agy --version

En el primer inicio se le pedirá configurar tres opciones:

• Esquema de color: elija Dark, Solarized Dark, Solarized Light o el valor predeterminado de su terminal.
• Modo de renderizado: elija Alt-Screen mode para un búfer a pantalla completa o Inline mode para mostrar la salida en el historial de la terminal.
• Confianza en el espacio de trabajo: confirme que confía en el directorio del repositorio antes de que el agente inicie la indexación de archivos.

Comandos habituales de la CLI, opciones de inicio y comandos slash

Ejecute agy en el directorio de un proyecto para iniciar una sesión interactiva. Las opciones modifican el modo de inicio:

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

La CLI guarda las preferencias persistentes en ~/.gemini/antigravity-cli/settings.json, y cualquier clave que omita utiliza su valor predeterminado.

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

Cómo funciona el archivo de configuración:

• Validación de esquema: añada "$schema": "https://antigravity.google/schemas/v1/settings.json" al principio del archivo para disponer de autocompletado y validación en editores como VS Code.
• Panel de ajustes: ejecute /config o su alias /settings para abrir el editor de configuración, cambie las opciones con las teclas de flecha y pulse Esc para cerrar.
• Telemetría de la cuenta: Enable Telemetry en /config no tiene una clave en settings.json porque la CLI guarda esa preferencia en su cuenta.

Otros ajustes residen en sus propios archivos:

• Atajos de teclado: ejecute /keybindings para abrir el editor de atajos de teclado y personalizar los atajos en ~/.gemini/antigravity-cli/keybindings.json.
• Gestor de permisos: ejecute /permissions para ver, añadir, editar y eliminar reglas action(target) en los ámbitos Project, Shared y Global.
• MCP y complementos: ejecute /mcp para abrir el gestor de servidores de Model Context Protocol, o /plugin para administrar complementos.
• Hooks de scripts: ejecute /hooks en el cuadro de entrada para explorar los hooks de scripts activos previos a la ejecución y posteriores al formateo.

Opciones principales de settings.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 continúan bloqueando una acción 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 las diferencias antes de que cambien los archivos.
• accept-edits: aprueba automáticamente la edición y creación de archivos en el espacio de trabajo.
• auto: aprueba las ediciones en el espacio de trabajo, ejecuta comandos en el sandbox de terminal por defecto y ejecuta comandos seguros y reversibles sin preguntar.
• Requisitos de auto: requiere la CLI v1.3.5+ en macOS y Linux o v1.4.4+ en Windows, el sandbox de terminal y una cuenta personal.
• plan: añade /plan para que el agente analice la base de código y esboce un plan antes de editar.

toolPermission establece cuándo solicita confirmación 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 se ejecuta dentro del sandbox de terminal.
• strict: solicita confirmación ante cada acción de herramienta, incluidas las lecturas de archivos, aunque coincida una regla de permiso, y prevalece sobre el modo auto.
• always-proceed: ejecuta comandos, solicitudes web y herramientas MCP sin preguntar, salvo que coincida una regla ask o deny, prevaleciendo sobre el modo auto.

Cómo permitir todos los permisos y comandos en agy

Existen varias formas de omitir la confirmación manual:

• Omitir todas las solicitudes de permisos durante una sesión: inicie agy --dangerously-skip-permissions para aprobar automáticamente todas las solicitudes de permisos de herramientas.
• Definir always-proceed: configure "toolPermission": "always-proceed" en settings.json para que los comandos, solicitudes web y herramientas MCP se ejecuten salvo que coincida una regla ask o deny.
• Omitir también las revisiones de ediciones y artefactos: añada "agentMode": "accept-edits" y "artifactReviewPolicy": "always-proceed" a settings.json:

{
  "agentMode": "accept-edits",
  "toolPermission": "always-proceed",
  "artifactReviewPolicy": "always-proceed"
}

• Permitir todos los comandos con una regla de comodín: añada command(*) a la lista allow en settings.json o mediante /permissions, y manténgala fuera de ask y deny.
• Usar el modo auto: inicie agy --mode=auto o defina "agentMode": "auto", de modo que las ediciones en el espacio de trabajo y los comandos seguros y reversibles se ejecuten sin preguntar.
• Usar Turbo en la aplicación de Antigravity: en la aplicación de escritorio, elija Turbo en Settings > General > Global Permissions > Permission Preset para desactivar el sandbox y permitir todas las acciones.

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 siguen un orden estricto: Deny primero, luego Ask y finalmente Allow. Así, con command(*) en ask y command(git) en allow, cada comando seguirá solicitando confirmación.

Cómo coinciden las reglas:

• Comodines globales: * coincide con cualquier destino de una acción, como read_file(*), command(*) o mcp(*).
• Prefijos de comandos y expresiones regulares: las reglas command coinciden literalmente por prefijo palabra por palabra de forma predeterminada, o mediante expresiones regulares cuando el destino comienza con regex:.
• Reglas implícitas: permitir write_file en una ruta también permite read_file en ella, y denegar read_file en una ruta también bloquea 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.
• Coincidencia de comandos en Windows: en PowerShell o en el Símbolo del sistema, los comandos que no pueden dividirse limpiamente en palabras necesitan una coincidencia exacta o una regla regex:, como command(regex:git .*).
• Edición en el aviso: antes de confirmar Allow en una tarjeta de aviso de archivo, URL o MCP, puede editar la cadena de destino para ampliar su alcance durante el turno.

{
  "permissions": {
    "allow": [
      "command(git)",
      "command(regex:npm run (build|lint|test))",
      "read_file(/var/log/app)",
      "write_file(src/)",
      "read_url(google.com)",
      "mcp(linter/*)"
    ],
    "deny": [
      "command(rm -rf)",
      "command(regex:curl .*)",
      "command(sudo)",
      "write_file(.git/)",
      "write_file(/home/user/.ssh)"
    ],
    "ask": ["command(*)", "execute_url(aws.amazon.com)", "mcp(sql/execute_mutation)"]
  }
}

Gestionar reglas de forma interactiva con /permissions

Escriba /permissions en el cuadro de entrada y pulse Enter para abrir el panel del gestor de permisos:

• Selector de ámbito: use las teclas de flecha o J y K para elegir Project, Shared o Global, y luego pulse Enter.
• Visor de reglas: cambie entre las pestañas allowlist, denylist y asklist con las teclas de flecha izquierda y derecha o Tab.
• Añadir una regla: pulse A, escriba una regla en formato action(target) como command(git) y pulse Enter para validarla y guardarla.
• Editar o eliminar una regla: seleccione una regla y pulse E o Ctrl + G para editarla, o pulse D o Backspace para eliminarla.

Notificaciones, confirmaciones de herramientas y atajos de teclado

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 una respuesta, o al finalizar su turno.

En el modo predeterminado, la CLI hace una pausa antes de modificar archivos o ejecutar comandos. Estas teclas responden a sus avisos:

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: ejecutar agentes de programación en paralelo.

Si también utiliza el editor independiente, consulte Google Antigravity IDE: editor, agentes y permisos 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 Servidores MCP de Google Antigravity: configurar y gestionar herramientas.

Para instalar la CLI en PowerShell o en el Símbolo del sistema, configurar su PATH de Windows y habilitar el sandbox AppContainer, consulte Google Antigravity en Windows: instalación, CLI y configuración.

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, o en un iPhone (iOS 17+) o teléfono Android (Android 8.0+) con Orbtile Mobile. Funciona en un ordenador con macOS 14.0 Sonoma o posterior con Apple silicon, o Windows 11 (x64).

• Aplicación de escritorio de Antigravity: Orbtile sigue las conversaciones en la aplicación de escritorio de Antigravity y asigna a cada una una tecla con su título, estado y texto de respuesta en directo.
• Preguntas en espera primero: una conversación que aguarda respuesta a una pregunta pasa al frente y, desde Orbtile 0.3.4, utiliza el color de alarma terracota compartido.
• Responder desde las teclas: puede responder hasta cuatro preguntas de opciones numeradas, con entre dos y cuatro opciones cada una, desde el teclado.
• En su ordenador: las solicitudes de permisos y las respuestas escritas permanecen en su ordenador.
• CLI e IDE de Antigravity: las sesiones de la CLI y del IDE no aparecen automáticamente, pero un script de hook de la CLI puede informar cada sesión a la Adapter API local de Orbtile.
• Activar la Adapter API: en Orbtile, abra Settings > Agents, elija Build your own, active Let your own tools show sessions y autorice su adaptador.
• Todos los agentes en un solo panel: el mismo teclado o teléfono muestra también 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 Mostrar cualquier script o agente en un teclado con la Adapter API de Orbtile.