Como migrar do Gemini CLI para Antigravity CLI

Resposta direta: faça a migração em paralelo: inventarie configurações, instale pelo canal oficial, converta plugins e skills, revise MCP e permissões, execute uma regressão representativa e só então retire o Gemini CLI. Não trate o primeiro login como prova de equivalência.

Checklist antes da instalação

  • Versão atual do Gemini CLI e método de autenticação.
  • Arquivos GEMINI.md e AGENTS.md.
  • Skills locais e globais.
  • Extensões, hooks, subagentes e servidores MCP.
  • Comandos usados em scripts, CI e documentação interna.
  • Permissões concedidas ao agente e caminhos sensíveis.

Migração em sete etapas

  1. Faça backup versionado das configurações.
  2. Instale o Antigravity CLI apenas pelo canal oficial.
  3. Execute o onboarding e revise cada conversão proposta.
  4. Converta extensões para plugins e confirme seus fornecedores.
  5. Mova ou referencie skills sem apagar a origem.
  6. Reconfigure MCP e teste autenticação de cada servidor.
  7. Rode a mesma tarefa, testes e inspeção de diff nas duas ferramentas.

Critério de saída e rollback

Defina antecipadamente o que precisa funcionar: autenticação, leitura do repositório, edição, testes, plugins, MCP, hooks, CI e cancelamento seguro. Se qualquer item crítico falhar, reverta a configuração apontando para o backup e mantenha o Gemini CLI enquanto sua credencial ainda tiver suporte.

O que evitar

Não execute instaladores copiados de posts, não conceda permissões amplas para “fazer funcionar”, não apague a pasta anterior antes da regressão e não presuma que nomes semelhantes significam caminhos idênticos.

Fontes oficiais: anúncio do Google Developers Blog · comunicado dos mantenedores · documentação de migração

Perguntas frequentes

Preciso remover o Gemini CLI antes?

Não. A rota mais segura é instalar e testar o Antigravity CLI em paralelo até concluir a regressão.

O que deve entrar no backup?

Configurações, instruções, skills, hooks, extensões, MCP, autenticação não secreta e documentação dos fluxos de CI.

Quando a migração termina?

Quando os fluxos críticos passam nos critérios definidos e existe um rollback testado, não apenas quando o novo CLI abre.