# Antigravity CLI: guia prático do agy do Google

URL: https://agentvera.dev/pt/blog/how-to-use-antigravity-cli/ · Publicado: 2026-11-05

Guia do Antigravity CLI: instale o agy, faça login, escreva o AGENTS.md, escolha modelo e effort, configure modos, permissões e MCP e migre do Gemini CLI.

**Resumo:**

- O Antigravity CLI (agy) é o agente de terminal do Google que substituiu o Gemini CLI para Google AI Pro, Ultra e usuários individuais gratuitos em 18 de junho de 2026.
- Instale com um script, rode agy no projeto e entre com sua conta Google; as regras continuam no AGENTS.md ou GEMINI.md, que ele lê sem mudanças.
- Os servidores MCP saem do settings.json para o mcp_config.json, as extensões viram plugins com agy plugin import gemini e --mode substitui --approval-mode.

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](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ "Transição do Gemini CLI para o Antigravity CLI") 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](https://antigravity.google/docs/getting-started?tab=cli "Início rápido 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](/pt/glossary/coding-agent/ "O que é 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](/pt/blog/how-to-use-gemini-cli/ "Como usar o 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

| Sistema | Comando |
| --- | --- |
| macOS, Linux | `curl -fsSL https://antigravity.google/cli/install.sh \| bash` |
| Windows (PowerShell) | `irm https://antigravity.google/cli/install.ps1 \| iex` |
| Windows (CMD) | `curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd` |

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

```bash
agy --version
```

## Login

Entre no projeto e inicie:

```bash
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

```text
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.

```markdown
# 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](/pt/blog/claude-md-agents-md/ "CLAUDE.md e 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

| Modo | O que acontece |
| --- | --- |
| `default` | Mostra um diff antes de criar ou alterar arquivos e pergunta antes de comandos |
| `accept-edits` | Aprova edições no workspace, mas continua perguntando antes de comandos |
| `auto` | Aprova edições e roda comandos no sandbox do terminal; ações arriscadas ainda pedem confirmação |
| `plan` | Analisa e descreve os passos antes de escrever código |

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](/pt/blog/ai-coding-agent-security/ "Segurança de agentes de IA").

## Servidores MCP

Servidores [MCP](/pt/glossary/mcp/ "O que é MCP") têm arquivo próprio: `~/.gemini/config/mcp_config.json` para todos os projetos e `.agents/mcp_config.json` para um workspace.

```json
{
  "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

| Comando | O que faz |
| --- | --- |
| `/model`, `/effort` | Troca o modelo e o nível de raciocínio |
| `/permissions` | Gerencia regras allow, ask e deny |
| `/config` ou `/settings` | Abre as configurações |
| `/mcp` | Gerenciador de servidores MCP |
| `/plan` | Pesquisa, faz perguntas e escreve um plano revisável |
| `/resume` | Escolhe uma conversa anterior desta pasta |
| `/rewind`, `/undo` | Volta na conversa |
| `/fork`, `/clear` | Ramifica a conversa ou recomeça do zero |
| `/usage`, `/credits` | Cotas dos modelos e créditos de IA |
| `/plugin` | Instala, ativa ou lista plugins |

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](https://antigravity.google/docs/cli/gcli-migration "Migração do Gemini CLI") 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](https://antigravity.google/docs/plans "Planos do Antigravity") 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](/pt/blog/git-worktree-parallel-agents/ "Git worktrees para agentes em paralelo") 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](/pt/agents/antigravity/ "Antigravity no AgentVera")):

- **[Workspace](/pt/features/workspace/ "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](/pt/features/mcp-manager/ "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](/pt/features/git-and-github/ "Git e GitHub") 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](/pt/blog/gemini-cli-vs-claude-code/ "Gemini CLI vs Claude Code"), ou [baixe o AgentVera](/pt/download/ "Baixar 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.

## Perguntas frequentes

**O Antigravity CLI é gratuito?** Você pode entrar com uma conta pessoal do Google no plano Free, Pro ou Ultra. Segundo a página de planos do Google, os outros planos têm uma cota renovada toda semana, e Pro e Ultra uma cota maior renovada a cada cinco horas. O Google não publica números exatos.

**O Antigravity CLI lê o meu GEMINI.md?** Sim. Ele lê AGENTS.md e GEMINI.md na pasta onde você inicia o agy e nas pastas acima até a raiz do repositório, além de arquivos globais como ~/.gemini/GEMINI.md. Vindo do Gemini CLI, não precisa mudar nada.

**Onde ficam os servidores MCP no Antigravity CLI?** Em um mcp_config.json separado: ~/.gemini/config/mcp_config.json para todos os projetos ou .agents/mcp_config.json para um workspace. Servidores remotos usam serverUrl e precisam falar Streamable HTTP.

**O que substituiu --approval-mode e yolo?** A flag --mode, com default, accept-edits, auto e plan. Shift+Tab alterna os modos na sessão. Para pular todas as confirmações existe --dangerously-skip-permissions, que só faz sentido em um ambiente isolado.

**Posso continuar no Gemini CLI?** Sim, se você tiver uma licença Gemini Code Assist Standard ou Enterprise ou uma chave paga da API Gemini. Usuários Google AI Pro, Ultra e usuários individuais gratuitos foram migrados para o Antigravity CLI em 18 de junho de 2026.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/