Antigravity CLI: guia prático do agy do Google

O Antigravity CLI é o agente de programação do Google para o terminal. Você instala com um script, inicia com agy dentro de um projeto, entra com sua conta Google e descreve a tarefa. Ele lê seus arquivos, propõe edições e comandos e, no modo padrão, pergunta antes de mudar qualquer coisa.

Se você usava o Gemini CLI com uma conta pessoal, foi aqui que você foi parar. O Google anunciou no blog para desenvolvedores em 19 de maio de 2026 que o Gemini CLI deixaria de atender assinantes do Google AI Pro e Ultra e usuários gratuitos do Gemini Code Assist para pessoas físicas em 18 de junho de 2026. Este guia cobre instalação, login, instruções do projeto, modelos e effort, modos e permissões, MCP, comandos principais, a migração do Gemini CLI e os limites que o Google informa. Tudo vem da documentação do Antigravity em novembro de 2026.

O que é o Antigravity CLI e para quem

O Antigravity CLI é o cliente de terminal do Google Antigravity, a plataforma de desenvolvimento centrada em agentes do Google. Segundo o Google, ele é escrito em Go e compartilha o motor do agente com o app desktop Antigravity 2.0, então as melhorias chegam aos dois. Ele mantém as peças que quem usava o Gemini CLI conhece: agent skills, hooks, subagentes e extensões, que agora se chamam plugins.

Ele é para você se:

• você usava o Gemini CLI com conta pessoal do Google, Google AI Pro ou Ultra;
• quer um agente de programação no terminal rodando modelos Gemini (e outros, dependendo do plano);
• já usa o Antigravity no desktop e quer o mesmo agente via SSH ou em scripts.

Equipes com licença Gemini Code Assist Standard ou Enterprise, ou com uma chave paga da API, podem ficar no Gemini CLI; nosso guia do Gemini CLI cobre esse caminho. O Google é transparente sobre a diferença: o anúncio diz que não haverá paridade de recursos 1:1 logo de início.

Instalação

No macOS e no Linux o binário fica em ~/.local/bin/agy; no Windows, em AppData\Local\agy\bin. Confira:

agy --version

Login

Entre no projeto e inicie:

cd meu-projeto
agy

Na primeira vez ele pede um esquema de cores, um modo de renderização (Alt-Screen ou Inline) e se você confia na pasta. Depois abre o navegador para você entrar com a conta Google. Contas pessoais nos planos Free, Pro e Ultra funcionam; contas empresariais entram pelo Gemini Enterprise. O token fica no chaveiro do sistema (Keychain, Secret Service ou Gerenciador de Credenciais do Windows), então as próximas aberturas dispensam o navegador.

Outras opções:

• Via SSH: o agy mostra uma URL. Abra no seu computador, faça login e cole o código no terminal.
• Chave da API Gemini: coloque "modelProvider": "gemini" em ~/.gemini/antigravity-cli/settings.json e exporte GEMINI_API_KEY. Sem essa configuração, a chave sozinha não faz nada.
• Credenciais do Google Cloud: rode gcloud auth application-default login e defina AGY_ADC_AUTH=true.

/logout apaga o login salvo.

Sua primeira tarefa

Explique como o módulo de pagamentos está organizado, depois adicione
validação de entrada no endpoint de reembolso e rode os testes.

Alguns atalhos úteis desde o primeiro dia: @ sugere caminhos de arquivos, ! no início do prompt roda um comando de shell e ? mostra a ajuda com os slash commands. Para scripts, agy -p "resuma o README.md" roda um único prompt sem interface e imprime a resposta; adicione --output-format json quando outro programa for ler. agy -i "prompt" abre a interface interativa já com um primeiro prompt.

Instruções do projeto: AGENTS.md ou GEMINI.md

O Antigravity lê AGENTS.md ou GEMINI.md na pasta onde você inicia o agy e nas pastas acima até a raiz do repositório. Os dois estão sempre ativos e não precisam de frontmatter. Regras globais vão em ~/.gemini/AGENTS.md ou ~/.gemini/GEMINI.md. As regras se somam em vez de se substituírem.

# Projeto: billing-service

## Comandos
- Instalar: npm ci
- Testar: npm test (rode antes de dizer que terminou)

## Não faça
- Não edite arquivos em src/generated.

Para um controle mais fino, coloque arquivos Markdown em .agents/rules/. Cada um precisa de frontmatter com um trigger: always_on, model_decision, glob (vale quando o agente mexe em arquivos que batem com o padrão) ou manual. Sem um trigger válido, a regra é descartada em silêncio, e o CLI não suporta regras manual, porque não tem menções a regras. Mantenha os arquivos curtos: cada um é cortado após 24.000 bytes, e as regras globais e always_on dividem um orçamento de 20.000 tokens.

Se o Codex ou outro agente já lê seu AGENTS.md, o Antigravity usa o mesmo arquivo. CLAUDE.md vs AGENTS.md mostra como compartilhar um único conjunto de regras com o Claude Code.

Modelos e effort

Escolha o modelo por execução com --model (agy models lista as opções) ou na sessão com /model. A página de modelos do Google mostra modelos Gemini como Gemini 3.8 Flash e Gemini 3.1 Pro ao lado de modelos Claude e GPT-OSS; quais aparecem depende do seu plano.

O effort define o quanto o modelo raciocina. /effort abre um seletor e salva a escolha como padrão; --effort low vale só para aquela execução. Os níveis são low, medium, high, xhigh e max, mas a maioria dos modelos oferece só de low a high, e modelos com orçamento fixo ignoram a opção.

Modos e permissões

Inicie com --mode=accept-edits (ou auto, plan), alterne com Shift+Tab ou defina "agentMode" em ~/.gemini/antigravity-cli/settings.json. O auto exige o sandbox e uma conta pessoal (v1.3.5+ no macOS e Linux, v1.4.4+ no Windows); contas empresariais não têm. --sandbox roda a sessão dentro do sandbox do terminal.

Regras detalhadas ficam no mesmo arquivo, em listas allow, ask e deny, por exemplo command(git) ou mcp(sql/execute_mutation). Deny vence ask, e ask vence allow. /permissions edita tudo pela interface. --dangerously-skip-permissions aprova tudo; use só em um ambiente descartável. O motivo está em segurança de agentes de programação com IA.

Servidores MCP

Servidores MCP têm arquivo próprio: ~/.gemini/config/mcp_config.json para todos os projetos e .agents/mcp_config.json para um workspace.

{
  "mcpServers": {
    "local-db": { "command": "node", "args": ["/path/to/server.js"] },
    "docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
  }
}

Servidores remotos precisam usar Streamable HTTP; o antigo transporte HTTP+SSE e httpUrl não são suportados. /mcp abre um gerenciador com status, recarga e logs. Ferramentas que você não liberou rodam no modo Ask.

Comandos que valem a pena

No shell, agy -c continua a última conversa da pasta e --conversation <id> abre uma específica. --add-dir adiciona outra pasta ao workspace.

Migrando do Gemini CLI

Na primeira vez que você roda o agy em uma máquina com configuração do Gemini CLI, uma lista pergunta o que migrar: extensões, configuração global, tokens de sessão e ajustes de exibição. Pelo guia de migração do Google:

• Sem mudanças: GEMINI.md e AGENTS.md do projeto, ~/.gemini/GEMINI.md e as skills globais em ~/.gemini/skills/.
• Convertido: extensões viram plugins com agy plugin import gemini, e os comandos delas viram skills.
• Mova à mão: as skills do workspace, de .gemini/skills/ para .agents/skills/; os servidores MCP, de ~/.gemini/settings.json para mcp_config.json, trocando url ou httpUrl por serverUrl.
• Sem garantia: alguns temas personalizados e camadas visuais.
• Flags: --approval-mode não existe mais; use --mode. Não há modo yolo.

Limites e preço

A página de planos do Google inclui o CLI em todos os planos e descreve as cotas sem números: o Ultra tem a cota mais alta, renovada a cada cinco horas; o Pro, uma cota alta renovada a cada cinco horas até um limite semanal; os outros planos, uma cota renovada toda semana. Os limites acompanham o volume de trabalho do agente. No Pro e no Ultra, créditos de IA podem cobrir o uso além da cota pelo preço de consumo do Gemini Enterprise, e uma configuração permite desligar isso. /usage e /credits mostram onde você está.

Ao lado do Claude Code e do Codex

O Antigravity costuma ser um entre vários agentes. Alguns hábitos ajudam:

• Um só arquivo de regras. Antigravity e Codex leem AGENTS.md; o Claude Code lê CLAUDE.md, que pode apontar para ele.
• Um worktree por agente. Dê a cada agente seu próprio git worktree para que não editem os mesmos arquivos.
• Os mesmos servidores MCP em todo lugar. Cada ferramenta tem sua própria configuração, então o mesmo servidor é adicionado três vezes.

Nós desenvolvemos o AgentVera, um app desktop para macOS, Windows e Linux que roda o Antigravity CLI ao lado do Claude Code, Codex, Gemini CLI e outros agentes, cada um em um terminal real com a sua instalação e o seu login. No caso do Antigravity (detalhes):

• Workspace: o Antigravity é uma célula na grade de agentes de cada projeto e volta à sua conversa quando o app reabre.
• Permissões: Perguntar, Auto (--mode=accept-edits) ou Acesso total (--dangerously-skip-permissions) por agente.
• Modelo e effort: escolha o modelo e effort low, medium ou high ao criar o agente.
• Instruções: o agy não tem flag para instruções extras, então mantenha as regras no AGENTS.md ou GEMINI.md.
• Gerenciador de MCP: servidores configurados uma vez entram no Antigravity ao iniciar, junto do seu próprio mcp_config.json.
• Worktrees: crie um pelo painel Git e inicie o Antigravity nele, com o Claude Code em outro.

A grade, os worktrees, o code review e o gerenciador de MCP estão no plano gratuito. Para comparar os agentes do Google com os da Anthropic, leia Gemini CLI vs Claude Code, ou baixe o AgentVera.

Resumindo

Instale com o script, rode agy, entre com o Google e mantenha seu AGENTS.md ou GEMINI.md. Mova os servidores MCP para mcp_config.json, importe as extensões com agy plugin import gemini, comece no modo default ou accept-edits e confira /usage antes de sessões longas.