Antigravity CLI (agy) num servidor

Desde 18 de junho de 2026, a Gemini CLI não atende mais contas pessoais gratuitas, Google AI Pro ou Ultra. O anúncio do Google direciona esses usuários para a Antigravity CLI, o agy. Num servidor, os pontos que pedem cuidado são fazer login sem navegador, escolher entre o login Google e uma chave de API e saber como o agy lida com permissões quando não há ninguém no terminal. Veja cada um, em ordem.

Instale o agy

No Linux ou no macOS, com o seu usuário normal (não root):

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"   # if ~/.local/bin isn't on PATH yet
command -v agy

A página oficial de instalação diz que o binário vai para ~/.local/bin/agy e lista macOS, Linux e Windows. O instalador baixa um build específico para cada plataforma, com builds Linux para amd64 e arm64, então uma VPS ARM funciona. Adicione a linha do PATH ao ~/.bashrc ou ao ~/.profile para que novos shells e janelas do tmux o encontrem.

Um hábito específico de servidor: o agy se atualiza sozinho em segundo plano. No notebook isso é prático. Numa máquina que fica ligada, significa que a versão pode mudar no meio de uma sessão longa. O Maude fixa a versão que instala e desativa esse comportamento com AGY_CLI_DISABLE_AUTO_UPDATE=1. Se você quer a mesma previsibilidade, exporte essa variável no shell ou na unit que inicia o agy.

Login por SSH

Inicie o agy numa sessão SSH e escolha o login com Google. No notebook, ele abriria um navegador. Por SSH, ele detecta a sessão remota e mostra uma URL de autorização. Depois:

1. Copie a URL e abra no celular ou no notebook.
2. Faça login com a conta Google que você usa no Antigravity.
3. Copie o código que a página mostrar e cole de volta no terminal.

As credenciais ficam guardadas no keyring do sistema, que no Linux é o Secret Service. Uma VPS crua não tem sessão de desktop para desbloquear um keyring. Uma issue no GitHub aberta contra o agy 1.0.0 relata um loop de login no Linux headless causado exatamente por isso, além de um bug de fuso horário no fallback para arquivo. A solução de contorno de quem relatou foi GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. Não confirmamos se as versões atuais ainda precisam disso. Se o agy pedir login de novo a cada vez que abre, essa issue é o primeiro lugar para olhar. Caso contrário, use o modo de chave de API.

Para sair e apagar o perfil salvo, rode /logout dentro do agy.

Modo de chave de API para uso headless

Para CI, uma máquina compartilhada ou qualquer servidor onde você prefira não manter uma sessão Google, rode o agy com uma chave da Gemini API. A documentação de instalação descreve dois passos. Primeiro, defina o provedor de modelo em ~/.gemini/antigravity-cli/settings.json. Se o arquivo já existir, mescle no conteúdo atual:

{
  "modelProvider": "gemini"
}

Depois, deixe a chave disponível para o processo:

export GEMINI_API_KEY="…"   # e.g. in ~/.profile, or an EnvironmentFile for a systemd unit

Isso dispensa totalmente o login na conta. O uso é cobrado por token pelo preço da Gemini API, em vez de contar contra um plano Google AI. Mantenha a chave fora do histórico do shell e fora do repositório em que o agente trabalha.

Permissões quando ninguém está olhando

Este é o comportamento de servidor que mais surpreende. Nos nossos testes com o agy 1.2.14, execuções headless (agy -p …, ou o modo stream-json) não conseguem parar e perguntar antes de uma ferramenta rodar. Um comando ou uma escrita de arquivo que precise de permissão é negado, e o resultado da rodada o lista como negado. Você tem três formas de deixar o trabalho passar:

• Regras de permissão. O agy as lê de permissions.allow em ~/.gemini/antigravity-cli/settings.json. As entradas têm a forma "command(npm test)", "write_file(src/app.ts)" ou "command(*)". Elas são lidas na inicialização.
• Modos. --mode accept-edits aprova automaticamente edições de arquivos, mas os comandos continuam sendo negados. --mode plan planeja sem agir.
• Nenhuma verificação. --dangerously-skip-permissions, para uma máquina descartável. Leia como rodar agentes com permissões totais com segurança antes de recorrer a isso.

O agy interativo num terminal, e o Remote Control (abaixo), podem pausar e perguntar. Então essa limitação vale especificamente para o uso headless, por script.

Trazendo sua configuração da Gemini CLI

O guia de migração trata disso. A versão curta, para um servidor que já tinha a Gemini CLI:

• Na primeira execução, ele oferece a migração. Se o agy encontrar uma configuração da Gemini CLI, mostra uma lista de extensões e configurações globais para converter.
• Extensões viram plugins. Rode agy plugin import gemini a qualquer momento para converter extensões do Gemini em plugins do Antigravity.
• Arquivos de contexto funcionam como estão. O GEMINI.md (do workspace e ~/.gemini/GEMINI.md) e o AGENTS.md são lidos sem mudanças.
• Servidores MCP precisam de um pequeno ajuste. Os globais ficam em ~/.gemini/config/mcp_config.json, os do workspace em .agents/mcp_config.json. Renomeie as chaves antigas url/httpUrl para serverUrl.
• As skills mudam de lugar. As skills do workspace vão de .gemini/skills/ para .agents/skills/, e as globais para ~/.gemini/antigravity-cli/skills/. Você mesmo precisa movê-las.

O Google diz que ainda não há paridade total de recursos, e o guia de migração observa que alguns temas personalizados e ajustes visuais não são migrados. Se um fluxo de trabalho depende de uma extensão específica, teste-o depois da importação antes de apagar a configuração antiga.

Daemon do Remote Control vs Maude

O Google oferece uma forma oficial de acessar o agy de outro dispositivo. Segundo a documentação do Remote Control, há três formas de iniciá-lo:

• /remote-control dentro de uma sessão em andamento. O túnel termina quando essa sessão da CLI é encerrada.
• agy --remote-control ao iniciar uma sessão. Esse túnel também termina quando a sessão é encerrada.
• O daemon headless: agy remote-control start --name my-vps, com agy remote-control status e agy remote-control stop. Ele registra um serviço do sistema que continua rodando em segundo plano.

Você o controla por um painel web em qualquer navegador, conectado com a mesma conta Google. A documentação diz que dá para instalar o painel na tela inicial do celular para receber notificações push, e que você pode responder aos pedidos de permissão tanto pelo terminal quanto pela interface remota. Ela também diz que uma feature flag da conta ou da organização pode bloqueá-lo.

Se o Antigravity é o único agente que você usa e a feature flag está ativa na sua conta, o daemon oficial é a primeira escolha óbvia. Ele é grátis e consegue perguntar antes de agir.

Comande pelo celular

Se você quer o agy num servidor junto com outros agentes e comandado por um app nativo, o Maude é uma opção. Adicione o servidor, e o app instala o agy numa versão testada e faz o seu login pelo celular. Você pode usar o login com Google colando um código, ou uma chave de API Gemini. Para ser transparente sobre o Antigravity no Maude: como o Maude comanda o agy headless, ele não consegue parar e perguntar antes de uma ferramenta rodar. O Maude mostra a ação negada e, se você aprovar, adiciona uma regra de permissão e tenta de novo. A página do agente Antigravity tem os detalhes. A mudança da Gemini CLI em si, e as alternativas para as quais as pessoas migraram, estão no nosso post sobre o fim da Gemini CLI.

Perguntas frequentes

O que mudou

• 1 de outubro de 2026 — Primeira publicação. Detalhes de instalação, autenticação, migração e Remote Control conferidos na documentação de antigravity.google; o comportamento de permissões em modo headless vem dos nossos próprios testes no agy 1.2.14.