Cheat Sheet Referência rápida
Português

Idioma

Referência rápida

Google Antigravity CLI (agy): Comandos e configuração — Folha de dicas

Guia de referência compacto para o agente de programação em terminal Google Antigravity CLI (agy): flags de inicialização e subcomandos, comandos slash e atalhos da TUI, configuração .agents/ e mcp_config.json, além de um checklist de migração do Gemini CLI.

· Publicado

Antigravity CLI (agy) é o agente de programação nativo para terminal do Google, leve e escrito em Go, integrante da plataforma Antigravity 2.0. Construído para execução paralela de subagentes, isolamento por Git worktree, Agent Skills, plugins e integrações MCP, o agy substitui o Gemini CLI voltado ao consumidor final.

Esta folha de dicas aborda flags e subcomandos do agy CLI, comandos slash interativos, atalhos de teclado, configuração .agents/ e mcp_config.json, além dos passos de migração do Gemini CLI.

🔗 Folhas de dicas relacionadas: Comparativo de CLIs de agentes de IA no terminal · Folha de dicas do Claude Code CLI · Folha de dicas do OpenAI Codex CLI · Arquitetura e desenvolvimento de AI Agent Skills

1. Instalação, subcomandos e flags de inicialização

1.1 Instalação e inicialização

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

# Iniciar a TUI interativa (siga os avisos de autenticação na tela na primeira execução)
agy

1.2 Subcomandos principais e flags de inicialização

Comando / Flag Descrição Exemplo de uso
agy Inicia a TUI interativa no workspace ativo agy
agy -p "<prompt>" Execução não interativa (headless), imprime a saída no stdout e encerra agy -p "Summarize the last 5 commits"
agy -i "<prompt>" Inicia sessão interativa preenchida previamente com um prompt inicial agy -i "Refactor auth middleware under src/auth"
agy -c, --continue Retoma a sessão de conversa mais recente agy -c
agy --conversation <id> Carrega uma conversa histórica específica pelo ID agy --conversation 42a506e6-...
--mode <mode> Define o modo de permissão de execução:
default · accept-edits · auto (autoaprovação em sandbox) · plan		 agy --mode accept-edits
--model <model> Sobrescreve o modelo ativo para esta sessão agy --model gemini-3.8-flash
--effort <level> Define o esforço de raciocínio (low até max, conforme o modelo) agy --effort high
--agent <agent> Anexa um perfil de agente personalizado na inicialização agy --agent reviewer
--add-dir <path> Concede acesso do contexto do workspace a um diretório extra (repetível) agy --add-dir ../shared-types
agy models / agy agents Lista os modelos disponíveis ou agentes personalizados configurados agy models
agy plugin <subcmd> Gerencia plugins: install · list · validate --strict · import gemini agy plugin validate --strict ./my-plugin

2. Comandos slash interativos da TUI

Digite / dentro do agy para invocar e autocompletar comandos integrados:

2.1 Controle geral, de sessão e histórico

Comando Função Observações e uso
? / /help Lista todos os comandos slash e atalhos de teclado disponíveis Referência rápida durante a sessão
/config / /settings Abre a tela interativa completa de configurações Edita preferências, temas e permissões (settings.json)
/clear Limpa o buffer do prompt ativo e inicia uma sessão nova Troca limpa para uma tarefa não relacionada
/compact Comprime e resume o histórico da conversa Recupera espaço de contexto em execuções longas
/resume Abre o seletor de conversas para restaurar sessões anteriores Continua fluxos de trabalho interrompidos
/rewind / /undo Retrocede passo a passo pelos turnos da conversa Reverte turnos ou direcionamentos incorretos
/fork Ramifica a conversa no checkpoint atual Explora branches paralelas do workspace com segurança
/exit / /quit Encerra a sessão do agy CLI Ou pressione Ctrl + D Ctrl + D

2.2 Modelos, fluxos de trabalho, agentes e extensões

Comando Função Observações e uso
/model Alterna o modelo de IA ativo durante a sessão Equilibra velocidade/custo versus poder de raciocínio
/effort Inspeciona ou define o esforço de raciocínio (low a max) Nota: agy -p "/effort" gera saída JSON somente leitura
/plan Gera um plano passo a passo antes de modificar arquivos Barreira de segurança antes de grandes mudanças de arquitetura
/goal Executa autonomamente até a conclusão sem pausas intermediárias Adequado para tarefas de longo horizonte
/grill-me Conduz uma entrevista interativa de requisitos antes de programar Esclarece casos de borda e critérios de aceitação desde o início
/agent Alterna ou invoca perfis personalizados de subagente/agente Carrega definições a partir de .agents/agents/
/worktree Cria ou gerencia diretórios isolados de Git worktree Trabalhe em branches paralelas sem poluir a árvore principal
/mcp Inspeciona status de conexão MCP ao vivo, logs e recarrega a configuração Diagnostica servidores MCP locais ou remotos
/plugin Navega, ativa, desativa ou inspeciona plugins do Marketplace Gerencia skills, regras, hooks e servidores MCP empacotados
/voice Alterna o modo de entrada por ditado de voz Atalho equivalente: F5

3. Atalhos de teclado no terminal e sintaxe de entrada

Atalho / Sintaxe Ação Efeito e cenário
@<path> Autocompletar de caminho de arquivo Injeta caminhos específicos de arquivos ou diretórios no contexto
!<command> Execução inline no terminal Prefixe com ! para rodar comandos shell diretamente (ex.: !npm run build)
Ctrl + G Abrir editor externo Escreva prompts longos ou multilinha no seu editor padrão (Vim, VS Code)
Esc Esc Limpar caixa de prompt ativa Limpa a entrada pendente quando nenhum stream estiver ativo
F5 Alternar ditado por voz Equivalente a /voice
Ctrl + D Ctrl + D Encerrar sessão Pressione Ctrl + D duas vezes para sair com segurança

4. Hierarquia de configuração e mcp_config.json

4.1 Mapa de diretórios global vs. workspace

Camada Escopo global (todos os workspaces) Escopo do workspace (local do projeto) Finalidade
Configurações do CLI ~/.gemini/antigravity-cli/settings.json — Preferências do CLI, tema, editor e padrões de permissão
Atalhos de teclado ~/.gemini/antigravity-cli/keybindings.json — Mapeamentos personalizados de teclas no terminal
Instruções do projeto ~/.gemini/AGENTS.md ou GEMINI.md ./AGENTS.md ou ./GEMINI.md Convenções persistentes do repo, comandos de build/teste, persona
Regras sempre ativas ~/.gemini/config/rules/*.md .agents/rules/*.md Restrições em segundo plano injetadas automaticamente no contexto
Agent Skills ~/.gemini/config/skills/<name>/SKILL.md .agents/skills/<name>/SKILL.md Pacotes modulares de Agent Skills com scripts e recursos
Configuração MCP ~/.gemini/config/mcp_config.json .agents/mcp_config.json Definições de servidores MCP locais (stdio) e remotos (HTTP)

⚠️ Esquema incompatível para MCP remoto (serverUrl): Em mcp_config.json, servidores MCP HTTP remotos devem usar serverUrl em vez das chaves legadas url ou httpUrl — usar url causa falhas silenciosas de conexão.

{
  "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. Migrando do Gemini CLI legado para o agy

A camada gratuita para consumidores e as requisições do Google AI Pro/Ultra no Gemini CLI foram encerradas em 18 de junho de 2026 (mantendo apenas o Gemini Code Assist corporativo e fluxos tarifados por chave de API). Principais mapeamentos de migração para o agy:

Componente Gemini CLI legado Antigravity CLI (agy) Ação de migração
Runtime e binário TypeScript open-source (gemini) CLI multiagente em Go (agy) Altere as invocações para agy; a configuração inicial roda automaticamente ao abrir
Extensões Extensões do Gemini CLI Plugins nativos do Antigravity Execute agy plugin import gemini para converter e importar
Arquivos de instruções GEMINI.md GEMINI.md e AGENTS.md Totalmente compatível — o GEMINI.md existente funciona sem alterações
Caminho local de Skills .gemini/skills/ .agents/skills/ Mova as pastas de skills para .agents/skills/<name>/SKILL.md
Workflows legados .agents/workflows/ Migrado para Agent Skills Converta workflows de arquivo único para .agents/skills/ (/migrate-workflows)
Config e chaves MCP Inline no settings.json usando url mcp_config.json dedicado usando serverUrl Separe os blocos MCP para mcp_config.json e renomeie url para serverUrl

Temas relacionados

#antigravity-cli#ai-coding#ai-agent#cli#cheat-sheet