Antigravity CLI (agy): configurações e liberar permissões

A CLI do Google Antigravity (agy) executa o agente de programação do Antigravity no seu terminal no macOS, Linux, Googlebook e Windows. Você a configura com comandos de barra como /config e /permissions ou em ~/.gemini/antigravity-cli/settings.json. Para liberar todas as permissões sem avisos de confirmação, inicie agy --dangerously-skip-permissions, defina "toolPermission": "always-proceed" ou adicione regras curinga em allow como command(*).

Instalar e iniciar a CLI do Antigravity (agy)

Instale a CLI do Antigravity (agy, v1.2+) com o instalador para o seu sistema operacional.

No macOS, Linux e Googlebook, execute:

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

O instalador coloca o binário em ~/.local/bin/agy por padrão.

No Windows, usando o PowerShell, execute:

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

No Windows, usando o Prompt de Comando (CMD), execute:

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

Ambos os instaladores do Windows colocam o binário em C:\Users\<username>\AppData\Local\agy\bin por padrão. Abra um terminal e verifique a instalação:

agy --version

Na primeira execução, você deverá configurar três itens:

• Esquema de cores: escolha Dark, Solarized Dark, Solarized Light ou o padrão do seu terminal.
• Modo de renderização: escolha Alt-Screen mode para um buffer em tela cheia ou Inline mode para exibir a saída no histórico do terminal.
• Confiança no workspace: confirme que você confia no diretório do repositório antes que o agente inicie a indexação dos arquivos.

Comandos comuns da CLI, flags de inicialização e comandos de barra

Execute agy no diretório de um projeto para iniciar uma sessão interativa. As flags alteram a forma de inicialização:

Configurar a CLI do Antigravity com o /config e settings.json

A CLI mantém as preferências permanentes em ~/.gemini/antigravity-cli/settings.json, e qualquer chave omitida utiliza o valor padrão.

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

Como funciona o arquivo de configurações:

• Validação de esquema: adicione "$schema": "https://antigravity.google/schemas/v1/settings.json" no início do arquivo para ter preenchimento automático e validação em editores como o VS Code.
• Painel de configurações: execute /config ou seu atalho /settings para abrir o Editor de Configurações, altere as opções com as setas e pressione Esc para fechar.
• Telemetria da conta: a opção Enable Telemetry em /config não possui uma chave no settings.json, pois a CLI salva essa escolha diretamente na sua conta.

Outros ajustes ficam em arquivos próprios:

• Atalhos de teclado: execute /keybindings para abrir o Editor de Atalhos de Teclado e personalizar os atalhos em ~/.gemini/antigravity-cli/keybindings.json.
• Gerenciador de permissões: execute /permissions para visualizar, adicionar, editar e excluir regras action(target) nos escopos Project, Shared e Global.
• MCP e plugins: execute /mcp para abrir o gerenciador de servidores do Model Context Protocol, ou /plugin para gerenciar plugins.
• Hooks de script: execute /hooks na caixa de prompt para consultar os hooks de script ativos de pré-execução e pós-formatação.

Principais opções do settings.json

Modos de execução e permissões de ferramentas

Duas configurações definem a frequência com que o agente para para consultar você: o modo de execução e toolPermission. As regras de bloqueio continuam impedindo uma ação em qualquer modo.

Defina o modo com agentMode no settings.json, para apenas uma sessão com --mode, ou alterne entre os modos com Shift + Tab:

• default (deixar agentMode sem valor): solicita sua revisão dos diffs antes de alterar arquivos.
• accept-edits: aprova edições e criações de arquivos no workspace automaticamente.
• auto: aprova edições no workspace, executa comandos no sandbox do terminal por padrão e roda comandos seguros e reversíveis sem pedir confirmação.
• Requisitos do modo auto: exige a CLI v1.3.5+ no macOS e Linux ou v1.4.4+ no Windows, o sandbox do terminal e uma conta pessoal.
• plan: adiciona /plan para que o agente analise a base de código e estruture um plano antes de editar.

A opção toolPermission define quando o agente pergunta antes de executar uma ferramenta:

• request-review (padrão): pergunta antes de executar ferramentas de escrita, bash, web ou MCP.
• proceed-in-sandbox: executa comandos de terminal sem perguntar quando o Modo Sandbox está ativo e o comando roda dentro do sandbox do terminal.
• strict: pergunta antes de cada ação de ferramenta, incluindo leitura de arquivos, mesmo que uma regra de permissão coincida, e prevalece sobre o modo auto.
• always-proceed: executa comandos, requisições web e ferramentas MCP sem pedir confirmação, a menos que uma regra ask ou deny coincida, sobrepondo-se ao modo auto.

Como liberar todas as permissões e comandos no agy

Existem várias maneiras de pular a confirmação manual:

• Pular todos os pedidos de permissão em uma sessão: inicie agy --dangerously-skip-permissions para aprovar automaticamente todas as solicitações de permissão de ferramentas.
• Definir always-proceed: configure "toolPermission": "always-proceed" no settings.json para que comandos, requisições web e ferramentas MCP rodem a menos que uma regra ask ou deny coincida.
• Pular também revisões de edição e de artefatos: adicione "agentMode": "accept-edits" e "artifactReviewPolicy": "always-proceed" ao settings.json:

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

• Liberar todos os comandos com uma regra curinga: adicione command(*) à lista allow no settings.json ou via /permissions, mantendo essa regra fora de ask e deny.
• Usar o modo auto: inicie agy --mode=auto ou defina "agentMode": "auto" para que edições no workspace e comandos seguros e reversíveis sejam executados sem confirmação.
• Usar Turbo no aplicativo Antigravity: no aplicativo para computador, escolha Turbo em Settings > General > Global Permissions > Permission Preset para desativar o sandbox e permitir todas as ações.

Regras de permissão: allow, ask e deny

As regras utilizam o formato action(target) nas listas allow, ask e deny sob permissions no settings.json. Essas listas ficam no seu arquivo de configurações global. Em caso de conflito, a ordem é rigorosa: Deny primeiro, depois Ask e por fim Allow. Dessa forma, com command(*) em ask e command(git) em allow, qualquer comando continuará pedindo confirmação.

Como as regras são aplicadas:

• Curingas globais: * coincide com qualquer alvo de uma ação, como read_file(*), command(*) ou mcp(*).
• Prefixos de comando e regex: regras command verificam prefixos palavra por palavra literalmente por padrão, ou usam expressões regulares quando o alvo começa com regex:.
• Regras implícitas: permitir write_file em um caminho também libera read_file nesse local, e negar read_file em um caminho também bloqueia write_file.
• Caminhos no Windows: letras de unidade como C: são removidas e barras invertidas viram barras normais antes da verificação das regras.
• Correspondência de comandos no Windows: no PowerShell ou Prompt de Comando, comandos que não podem ser divididos em palavras exigem correspondência exata ou uma regra regex:, como command(regex:git .*).
• Edição no aviso de confirmação: antes de confirmar Allow em um cartão de arquivo, URL ou MCP, você pode editar o texto do alvo para ampliar seu escopo na rodada.

{
  "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)"]
  }
}

Gerenciar regras de forma interativa com o /permissions

Digite /permissions na caixa de prompt e pressione Enter para abrir o painel do Gerenciador de Permissões:

• Seleção de escopo: utilize as teclas de seta ou J e K para escolher Project, Shared ou Global e depois pressione Enter.
• Visualização de regras: alterne entre as abas allowlist, denylist e asklist usando as setas para a esquerda e direita ou Tab.
• Inclusão de regra: pressione A, digite uma regra no formato action(target), como command(git), e pressione Enter para validá-la e salvá-la.
• Edição ou exclusão de regra: selecione uma regra e pressione E ou Ctrl + G para editá-la, ou pressione D ou Backspace para excluí-la.

Notificações, confirmações de ferramentas e atalhos de teclado

A opção notifications vem desativada por padrão. Ao ativá-la, a CLI toca o aviso sonoro do terminal e exibe uma notificação na área de trabalho quando o agente precisa de aprovação ou resposta, ou ao concluir sua rodada.

No modo padrão, a CLI faz uma pausa antes de alterar arquivos ou executar comandos. Estas teclas respondem aos avisos de confirmação:

Para gerenciar subagentes em segundo plano com /agents, ir até subagentes aguardando e aprová-los com Alt+J e Ctrl+K, e executar equipes multiagente com /teamwork, confira Multiagentes no Google Antigravity: execute agentes de programação em paralelo.

Se você também utiliza o editor independente, confira IDE do Google Antigravity: editor, agentes e permissões para ver como ele compartilha hooks globais e configura o modo Strict, o sandbox de terminal e as revisões de artefatos.

Para conectar bancos de dados, documentações e APIs externas com /mcp ou mcp_config.json, veja Servidores MCP no Google Antigravity: configure e gerencie ferramentas.

Para instalar a CLI no PowerShell ou no Prompt de Comando, configurar o PATH do Windows e ativar o sandbox AppContainer, consulte Google Antigravity no Windows: instalação, CLI e configuração.

Acompanhar sessões do Antigravity em um keypad ou celular com o Orbtile

O Orbtile exibe seus agentes de programação em um Logitech MX Creative Keypad, ou em um iPhone (iOS 17+) ou celular Android (Android 8.0+) executando o Orbtile Mobile. Ele roda em um computador com macOS 14.0 Sonoma ou posterior em Apple silicon, ou Windows 11 (x64).

• Aplicativo para computador do Antigravity: o Orbtile acompanha as conversas no aplicativo para computador do Antigravity e atribui a cada uma um botão com título, estado e texto da resposta em tempo real.
• Perguntas pendentes primeiro: uma conversa aguardando resposta a uma pergunta passa para a frente e, a partir do Orbtile 0.3.4, utiliza a cor terracota compartilhada de alerta.
• Resposta pelas teclas: você pode responder a até quatro perguntas com opções numeradas, contendo de duas a quatro escolhas cada, diretamente pelo keypad.
• Mantidos no seu computador: os avisos de permissão e as respostas escritas em texto permanecem no seu computador.
• CLI e IDE do Antigravity: as sessões da CLI e da IDE não aparecem automaticamente, mas um script de hook da CLI pode reportar cada sessão para a Adapter API local do Orbtile.
• Ativação da Adapter API: no Orbtile, abra Settings > Agents, escolha Build your own, ative a opção Let your own tools show sessions e autorize o seu adaptador.
• Todos os agentes em um só painel: o mesmo keypad ou celular também exibe sessões do Claude Code, Codex, ZCode e Kimi Code, além de sessões remotas via SSH.

Veja Notificações do Antigravity: saiba quando um agente está aguardando e Exiba qualquer script ou agente em um keypad com a Adapter API do Orbtile.