Migrar do Gemini CLI para o Antigravity CLI: um guia

A 19 de maio de 2026, a Google anunciou que encerraria o antigo Gemini CLI para todos os planos Free, Pro e Ultra a 18 de junho. Duas semanas depois da publicação deste guia, o comando gemini deixará de processar pedidos. Migrar do Gemini CLI para o Antigravity CLI com o comando agy é a única forma de continuar a usar as ferramentas da Google. O agy é desenvolvido em Go e arranca dezenas de vezes mais depressa.

Se tiver algo a funcionar no Gemini CLI — scripts de CI, tarefas cron noturnas, a extensão Gemini Code Assist para IDE — este guia explica como migrar numa só noite sem estragar nada.

O que vai deixar exatamente de funcionar a 18 de junho de 2026?#

Não se trata do «encerramento total do projeto», mas sim do fim dos três planos mais populares. Quem é afetado:

Do blogue oficial Google Developers:

Se usava o plano Free, como a maioria dos programadores individuais, e está a pensar «mas tenho uma conta paga», verifique exatamente como é faturada a sua chave API. O AI Pro não é faturação Cloud; é uma subscrição pessoal Google AI e será desativada. A faturação Cloud com um projeto pago não será desativada.

Porque é que a Google está a encerrar o Gemini CLI?#

O antigo gemini demorava «centenas de milissegundos» a arrancar porque o Node.js precisava de aquecer. O novo agy é compilado como um único binário estático em Go e arranca «em milissegundos». Para CI e scripts que chamam o CLI centenas de vezes por execução, a diferença é significativa.

O que a Google diz sobre a velocidade e o motivo:

Todas as funcionalidades principais do Gemini CLI foram transferidas:

• Agent Skills — a pasta .gemini/skills/ está agora em .agents/skills/.
• Hooks — os mesmos eventos (PreToolUse, PostToolUse, etc.); a sintaxe quase não mudou.
• Subagents — funcionam como antes e a respetiva configuração é migrada automaticamente.
• Extensions — passaram a chamar-se plugins Antigravity e são importadas com um único comando.

O que não foi migrado sem problemas: os servidores MCP e os scripts antigos que acedem diretamente a .gemini/config.json. Segundo a discussão no GitHub, alguns utilizadores relatam que as configurações MCP deixam de funcionar e têm de ser reescritas manualmente. Mais abaixo há uma secção dedicada a este tema.

A Google não está a encerrar o projeto de código aberto Gemini CLI:

Isso significa que pode criar um fork e continuar a usá-lo com a sua própria chave Gemini API. Mas agora trata-se de uma configuração paga através da faturação Cloud; a opção gratuita Code Assist chegou ao fim.

Como instalar o Antigravity CLI: comandos para macOS, Linux e Windows#

Antes de começar, faça uma verificação rápida: que plano tem? Se tiver um projeto Cloud pago e não houver um prazo a 18 de junho, a migração é útil, mas não urgente. Se estiver no Free/Pro/Ultra e tiver algo a funcionar no CLI, mude já, enquanto os planos ainda estão ativos, para poder comparar o comportamento na mesma tarefa.

macOS e Linux

Comando de uma linha com curl:

curl -fsSL https://antigravity.google/cli/install.sh | bash

O script deteta a plataforma, transfere o binário agy, verifica a respetiva soma de verificação e coloca-o em ~/.local/bin. Se esta pasta não estiver em PATH, adicione-a:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Verifique se o binário está disponível:

which agy
agy --version

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

O binário será instalado em C:\Users\[your_name]\AppData\Local\agy\bin. O instalador atualizará PATH automaticamente, mas abra uma nova janela do PowerShell para recarregar as variáveis.

Windows (CMD)

Se o PowerShell estiver bloqueado pelas políticas da sua empresa:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Verificar a instalação

Após a instalação em qualquer sistema operativo, execute:

agy doctor

O comando verifica a versão do binário, se existe uma configuração, a autenticação e o acesso à rede antigravity.google. Se não conseguir estabelecer ligação à Google, o problema está na sua região ou no proxy.

Autenticação

Na primeira vez que executar agy sem argumentos, será iniciado um assistente de configuração:

1. Escolha um tema para a interface.
2. Escolha um método de autenticação: Google OAuth (para contas pessoais) ou uma chave API.
3. Opcionalmente, importe desde logo a configuração de .gemini/.

Se escolher OAuth, será aberto um browser e será redirecionado para accounts.google.com; terá de dar o seu consentimento para a partilha de dados. Depois disso, o CLI funciona.

Como migrar a configuração e os plugins de .gemini para .agents#

Passo a passo:

1. agy plugin import gemini

   Execute o comando a partir de qualquer pasta. Migrará os plugins globais de ~/.gemini/ para ~/.agents/. Para os plugins do workspace (junto ao projeto), execute o comando dentro da pasta do projeto.

2. mv .gemini/skills/ .agents/skills/

   Mova as skills renomeando manualmente a pasta. O formato dos ficheiros é o mesmo; não é necessário reescrever o Markdown.

3. agy inspect

   Mostra os plugins, skills, hooks e subagents ativos. Compare-os com a lista que tinha no Gemini CLI — não deverá faltar nada.

4. agy config --edit

   Abre a configuração no editor predefinido ($EDITOR). Se algo não tiver sido detetado automaticamente, edite-o manualmente.

5. agy doctor

   Verificação final: binário, autenticação, plugins, rede. Se os quatro itens estiverem a verde, a migração da configuração está concluída.

Deixaria a antiga pasta .gemini/ no lugar como cópia de segurança durante um mês, para o caso de algo ter ficado de fora. Depois de usar o Antigravity durante uma semana e confirmar que está tudo lá, pode apagá-la.

Se trabalhar com AGENTS.md como configuração universal para todas as ferramentas de IA, não precisa de lhe mexer. O Antigravity CLI lê o ficheiro AGENTS.md na mesma pasta que o Claude Code ou o Codex.

Que variáveis de ambiente é necessário alterar?#

Tabela completa de substituições:

Se tiver segredos transmitidos nas GitHub Actions, abra Settings -> Secrets -> Actions e altere o nome das chaves. Os valores mantêm-se iguais (a chave da Google API não mudou durante a migração).

Verifique todos os locais onde possa aparecer GEMINI_:

# Find mentions throughout the project
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# In dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Depois de os substituir, reinicie o terminal e verifique a presença sem apresentar o segredo. Não ative o rastreio da shell nem copie valores de chaves para registos. A presença, por si só, não prova autorização; examine agy doctor separadamente:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor        # should show “authorized”

O que costuma correr mal durante a transição e como resolver#

Lista de verificação dos problemas iniciais:

1. Servidores MCP. Se usava mcp_servers em .gemini/config.json, poderão não ser detetados após agy plugin import gemini. Verifique com agy inspect — haverá uma secção mcp. Se estiver vazia ou apresentar erros, reescreva-a manualmente com agy config --edit. O formato está descrito na documentação oficial do Antigravity (procure a secção MCP).

2. Hooks personalizados. Se tinha um script bash em .gemini/hooks/ que lia $GEMINI_API_KEY, deixará de funcionar. Encontre esses locais: bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   Substitua as variáveis.

3. CI/CD. Nas GitHub Actions ou no GitLab CI, altere para agy os passos que usam o comando gemini. O nome do binário no instalador pode ser diferente, pelo que deve criar uma abstração com a variável $CLI_CMD.

4. Extensão IDE. A extensão Gemini Code Assist para VS Code será desativada juntamente com o CLI. A alternativa é o Antigravity IDE (um fork independente do VS Code) ou o AGENTS.md noutro editor de IA.

5. Carregamento de @[file]. Nas primeiras versões do Antigravity CLI, o comando @src/file.ts para carregar um ficheiro para o contexto tinha erros. Atualize para a versão mais recente: agy update.

Se algo crítico deixar de funcionar e não puder ser corrigido no prazo de uma hora, uma solução temporária para o plano Free é continuar a usar o Gemini CLI até 18 de junho e preparar a migração num ramo separado do repositório. Limite temporal: 14 dias.

Vale a pena continuar a usar ferramentas da Google depois de 18 de junho?#

O Antigravity 2.0 pode ser considerado uma opção de recurso para os casos em que a sua ferramenta principal (Claude Code ou Codex) não seja adequada. Para uma análise detalhada dos seus pontos fortes e fracos, consulte o guia do Google Antigravity 2.0.

Um resumo breve do que fazer, consoante a sua situação:

Lista de verificação da migração em 15 minutos#

1. Instalar o Antigravity CLI

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) ou irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. Iniciar o agy e autenticar

   Sem argumentos: agy. Escolha OAuth ou uma chave API.

3. Importar plugins de .gemini

   agy plugin import gemini — migra globalmente as extensões. Execute-o novamente dentro da pasta do projeto para os plugins do workspace.

4. Mover as skills

   mv .gemini/skills/ .agents/skills/. O conteúdo dos ficheiros mantém-se tal como está.

5. Substituir as variáveis de ambiente

   Nos ficheiros ~/.zshrc/~/.bashrc e .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Reinicie o terminal.

6. Verificar a instalação

   agy doctor — os quatro itens (binário, autenticação, plugins, rede) deverão estar a verde.

7. Executar uma tarefa de teste

   agy "write a README for the project in the current folder" — verifique se o resultado é semelhante ao produzido pelo Gemini CLI.

8. Atualizar as GitHub Actions / o GitLab CI

   Altere o nome do comando e os segredos de GEMINI_* para AV_*.

9. Manter .gemini/ como cópia de segurança

   Pode apagá-la 1–2 semanas depois de confirmar que está tudo a funcionar.

Por fim: 18 de junho não significa que «todos os seus projetos vão deixar de funcionar». Significa que o canal gratuito será desativado. O acesso pago à API Cloud continua disponível, o repositório do Gemini CLI continua disponível e é possível criar forks. Se usava o plano Free, tem de decidir antes de 18 de junho; caso contrário, o próximo gemini "something" devolverá um erro de autorização.