Migração Gemini CLI → Antigravity CLI

O Google anunciou em 19 de maio de 2026 que a Gemini CLI está sendo transicionada para a Antigravity CLI. Para clientes corporativos pagantes, nada muda. Para todos em uma conta Google AI Pro, Ultra ou gratuita do Gemini Code Assist para indivíduos, a Gemini CLI deixará de atender requisições em 18 de junho de 2026. Este é o plano de migração que você pode executar em uma noite, com rollback caso um fluxo de trabalho crítico apresente falhas.

1. O Anúncio

Dois canais do Google publicaram a transição no mesmo dia. O Google Developers Blog apresentou o cronograma. A conta @geminicli no X comprometeu-se com uma janela de migração de 30 dias para usuários de nível individual e uma exceção explícita de "nenhuma ação necessária" para clientes enterprise.

O Google DeepMind contextualizou a visão geral a partir de uma conta oficial separada — a CLI é uma parte de uma oferta para desenvolvedores com três superfícies, não um produto independente:

Os documentos oficiais de migração em antigravity.google/docs/gcli-migration são a fonte da verdade para o mapeamento arquivo por arquivo. Os passos abaixo seguem a ordem da documentação, com os pontos de atenção destacados onde os documentos os deixam implícitos.

2. TL;DR

• Prazo: 18 de junho de 2026 (nível individual)
• Afetados: Google AI Pro, Google AI Ultra, Gemini Code Assist gratuito
• Não afetados: Code Assist Standard / Enterprise, chaves de API do Gemini pagas
• Substituição: Antigravity CLI (binário: agy)
• Migração com um único comando: agy plugin import gemini
• Movimentações manuais necessárias: .gemini/skills/ → .agents/skills/, configuração MCP para mcp_config.json
• Renomeação de campo: MCP remoto url → serverUrl
• Arquivos de contexto: GEMINI.md e AGENTS.md continuam funcionando sem alterações
• Instalação paralela: seguro — gemini e agy coexistem
• Tempo de leitura deste guia: 14 minutos; execução: cerca de 45 minutos

3. O Cronograma

4. Quem é Afetado

Faça esta verificação rápida antes de continuar a leitura:

• Você faz login no Gemini CLI com uma conta pessoal do Google. Você é afetado — este é o fluxo gratuito / para consumidores.
• Você paga pelo Google AI Pro ou Google AI Ultra. Você é afetado. O Antigravity CLI utiliza a mesma assinatura.
• Você usa o Gemini Code Assist for individuals (nível gratuito). Você é afetado. Tanto o Gemini CLI quanto a extensão de IDE do Code Assist serão descontinuados em 18 de junho.
• Você autentica o Gemini CLI com uma API key paga do Gemini. Você não é afetado. O Gemini CLI continua disponível para usuários de API key paga.
• Sua organização possui uma licença Gemini Code Assist Standard ou Enterprise. Você não é afetado. O acesso ao CLI Enterprise permanece inalterado.

5. Exceção para Enterprise

De acordo com o Google Developers Blog: “Se a sua organização utiliza o Gemini CLI ou nossas extensões de IDE por meio de uma licença Gemini Code Assist Standard ou Enterprise, ou se a sua organização utiliza o Gemini Code Assist para GitHub via Google Cloud, seu acesso permanece inalterado. Continuaremos a oferecer suporte ao Gemini CLI e ao Gemini Code Assist com acesso aos modelos Gemini mais recentes e outras atualizações.”

Concretamente, as empresas mantêm três opções:

• Manter o Gemini CLI na licença Standard / Enterprise — nenhuma migração é necessária.
• Manter o Gemini CLI com uma chave de API paga — nenhuma migração é necessária.
• Adotar o Antigravity CLI em paralelo, usando credenciais de projeto do GCP. Consulte a página oficial para empresas para detalhes sobre a vinculação de projetos do GCP.

Se você é um administrador corporativo lendo isso para outra pessoa, o ponto principal para você é planeje um piloto, não faça uma migração por pânico na organização. O prazo aplica-se apenas ao nível de consumidor.

6. Checklist de Pré-Voo

Antes de iniciar a migração, confirme:

• Sua máquina pode instalar um binário distribuído em Go (agy) — você tem acesso a curl, irm ou shell de administrador.
• Você sabe qual conta do Google está no seu Gemini CLI hoje (a migração mantém a mesma conta).
• Você consegue listar suas extensões instaladas do Gemini CLI (gemini extension list).
• O seu ~/.gemini/ diretório está intacto (ele contém suas regras e skills globais).
• Projetos de workspace com pastas .gemini/ personalizadas são identificados — cada um precisa de uma movimentação manual para skills de escopo de workspace.
• Se você cria scripts de chamadas da Gemini CLI via CI ou cron, você tem um plano de transição para alterar o nome do binário (gemini → agy) e o fluxo de autenticação.

7. Passo 1: Instalar a Antigravity CLI

Um comando de instalação por plataforma, extraído do README oficial:

# 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

Após a instalação, verifique:

agy --version
# expected: a version string is printed

O binário chama-se agy, não antigravity. Se você cria scripts de chamadas de CLI, esta é a sua renomeação. O binário da Gemini CLI geminipermanece no lugar; os dois coexistem.

8. Passo 2: Autenticar

A primeira execução abre um fluxo de autenticação. Duas variantes:

• Terminal local. Execute agy. Seu navegador padrão será aberto. Faça login com a mesma conta Google usada no Gemini CLI. O token é armazenado no chaveiro do sistema.
• Remoto / SSH. Execute agy. A CLI detecta a sessão SSH e exibe uma URL de autorização. Abra-a em sua máquina local, conclua o fluxo OAuth e a sessão SSH obtém o token. Isso era um ponto problemático notável no início do Gemini CLI — agora é um recurso de primeira classe.
• Enterprise. Durante o onboarding, você pode conectar um projeto do GCP. As chamadas são então faturadas contra esse projeto. A documentação oficial enterprise detalha as especificidades.

9. Passo 3: Importar Plugins

On first launch, Antigravity CLI prompts to migrate Gemini CLI extensions to Antigravity plugins. If you skip the prompt or are installing on a fresh machine, run the import explicitly:

agy plugin import gemini

Exemplo de saída da documentação oficial de migração, percorrendo uma extensão de múltiplos componentes:

[ok]    conductor
          - skills      : skipped (not found)
          - agents      : skipped (not found)
          ✔ commands    : 6 processed (converted to skills)
          - mcpServers  : skipped (not found)
          - hooks       : skipped (not found)
[ok]    google-workspace
          ✔ skills      : 6 processed
          - agents      : skipped (not found)
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          - hooks       : skipped (not found)

10. Passo 4: Mover Configurações MCP

O Gemini CLI armazenava os servidores MCP inline no settings.json. O Antigravity CLI utiliza um arquivo separado. Mova-os:

E uma renomeação de campo no próprio JSON:

// Gemini CLI (settings.json)
{
  "mcpServers": {
    "my-remote-mcp": {
      "url": "https://example.com/mcp"   // or the deprecated "httpUrl"
    }
  }
}

// Antigravity CLI (mcp_config.json)
{
  "my-remote-mcp": {
    "serverUrl": "https://example.com/mcp"
  }
}

Servidores MCP remotos falharão silenciosamente se você copiar url sem renomear. Entradas de servidor MCP locais com command + args não precisam da renomeação. Para mais informações sobre a configuração do MCP, veja nosso tutorial de MCP.

11. Passo 5: Mover Workspace Skills

Skills globais em ~/.gemini/skills/ carregam automaticamente — nenhuma ação é necessária. Skills de workspace em .gemini/skills/ devem ser movidas para .agents/skills/:

# Per project, from the workspace root:
mkdir -p .agents
git mv .gemini/skills .agents/skills
# Or, if not in git:
mv .gemini/skills .agents/skills

Se um workspace já possuía uma .agents/skills/ pasta (o caso de localização dupla que a documentação da Gemini CLI permitia), mantenha essa e remova a .gemini/skills/ cópia. Para padrões de criação, veja nosso Guia de configuração de skills do Antigravity.

12. Passo 6: Verificar Hooks e Contexto

Duas coisas para confirmar antes de considerar a migração concluída:

• Os arquivos de Contexto carregam. GEMINI.md e AGENTS.md no workspace, além de ~/.gemini/GEMINI.md globalmente, todos continuam funcionando sem alterações. Abra uma sessão e peça ao agente para recitar uma regra conhecida do seu arquivo.
• Os hooks JSON são disparados. Se você criou hooks JSON para o Antigravity 2.0 ou Gemini CLI, eles se aplicam no Antigravity CLI nos mesmos momentos do ciclo de vida. Altere um arquivo ou execute uma chamada de ferramenta de exemplo para confirmar que um hook conhecido realmente é disparado.

Para padrões de regras, veja nossos exemplos de regras e guia de system prompt do GEMINI.md.

13. Passo 7: Validação com Tarefas Reais

O passo que você não deve pular. Escolha uma tarefa que você fez ontem no Gemini CLI — um refactor, uma sessão de pesquisa ou uma edição de múltiplos arquivos — e execute-a no Antigravity CLI no mesmo repositório. Compare:

• O agente acessou as mesmas ferramentas nas mesmas etapas?
• Seus comandos de barra de skills funcionaram nos lugares certos?
• As chamadas de MCP-server foram disparadas? (Fique atento a serverUrl falhas silenciosas aqui.)
• Os arquivos de contexto (GEMINI.md, AGENTS.md) moldaram o comportamento da mesma forma?
• Os hooks foram invocados nos momentos do ciclo de vida que você esperava?

Vinte a trinta minutos em uma tarefa representativa fornecem 90% do sinal que você precisa. Se tudo for reproduzido, você terminou. Se algo quebrar, registre o problema e use o Gemini CLI como alternativa para esse workflow até que haja uma correção.

14. Plano de Rollback

O Antigravity CLI e o Gemini CLI coexistem na mesma máquina. Eles são binários separados (agy vs gemini), árvores de configuração separadas (~/.gemini/antigravity-cli/ ao lado de ~/.gemini/), e fluxos de autenticação separados. Até 18 de junho de 2026, seu rollback para qualquer workflow individual é simplesmente: continuar executando gemini para aquela tarefa específica.

Após 18 de junho, as opções de rollback se limitam a:

• Fazer upgrade para uma licença enterprise (Gemini Code Assist Standard / Enterprise).
• Mudar para uma chave de API do Gemini paga.
• Usar o Antigravity 2.0 (a GUI) em vez da CLI para o workflow afetado.
• Usar uma CLI de agente totalmente diferente. Veja nosso compilado de alternativas para o cenário atual.

15. O que muda em resumo

16. FAQ

17. Veredito

Se você for fazer apenas uma coisa hoje: instale o Antigravity CLI na máquina onde você mais utilizava o Gemini CLI. A partir daí, tudo o mais exigirá um compromisso menor.

Fontes

• Google Developers Blog — Uma atualização importante: Transição do Gemini CLI para o Antigravity CLI
• @geminicli no X — anúncio de transição
• Antigravity CLI — Migrando do Gemini CLI (docs oficiais)
• Apresentando o Google Antigravity CLI — antigravity.google
• Apresentando o Google Antigravity 2.0 — antigravity.google
• Visão Geral do Antigravity CLI — docs oficiais
• google-antigravity/antigravity-cli — repositório GitHub