Migrazione da Gemini CLI ad Antigravity CLI: una guida

Il 19 maggio 2026, Google ha annunciato che il 18 giugno chiuderà il vecchio Gemini CLI per tutti i piani Free, Pro e Ultra. Due settimane dopo la pubblicazione di questa guida, il comando gemini smetterà di elaborare le richieste. Migrare da Gemini CLI ad Antigravity CLI con il comando agy è l’unico modo per continuare a usare gli strumenti Google. agy è sviluppato in Go e si avvia decine di volte più velocemente.

Se hai qualcosa in esecuzione su Gemini CLI—script CI, processi cron notturni, l’estensione IDE Gemini Code Assist—questa guida spiega come migrare in una sera senza rompere nulla.

Che cosa smetterà esattamente di funzionare il 18 giugno 2026?#

Non si tratta della «chiusura completa del progetto», ma dell’interruzione dei tre piani più popolari. Chi è interessato:

Dal blog ufficiale Google Developers:

Se usavi il piano Free, come la maggior parte degli sviluppatori individuali, e stai pensando «ma ho un account a pagamento», controlla esattamente come viene fatturata la tua chiave API. AI Pro non è fatturazione Cloud: è un abbonamento personale a Google AI e verrà disabilitato. La fatturazione Cloud con un progetto a pagamento non verrà disabilitata.

Perché Google sta chiudendo Gemini CLI?#

Il vecchio gemini si avviava in «centinaia di millisecondi» perché Node.js doveva inizializzarsi. Il nuovo agy è compilato come singolo binario statico Go e si avvia in «millisecondi». Per CI e script che chiamano la CLI centinaia di volte per esecuzione, la differenza è notevole.

Cosa dice Google sulla velocità e sul motivo:

Tutte le funzionalità principali di Gemini CLI sono state trasferite:

• Agent Skills — la cartella .gemini/skills/ ora si trova in .agents/skills/.
• Hooks — gli stessi eventi (PreToolUse, PostToolUse, ecc.); la sintassi è cambiata pochissimo.
• Subagents — funzionano come prima e la loro configurazione viene migrata automaticamente.
• Estensioni — rinominate plugin Antigravity e importate con un solo comando.

Cosa non è migrato senza problemi: i server MCP e i vecchi script che accedono direttamente a .gemini/config.json. Secondo la discussione su GitHub, alcuni utenti segnalano che le configurazioni MCP si interrompono e devono essere riscritte manualmente. Più avanti c’è una sezione dedicata.

Google non sta chiudendo il progetto open source Gemini CLI:

Questo significa che puoi farne un fork e continuare a usarlo con la tua chiave API Gemini. Ma ora è una configurazione a pagamento tramite fatturazione Cloud; l’accordo gratuito Code Assist è terminato.

Come installare Antigravity CLI: comandi per macOS, Linux e Windows#

Prima di iniziare, fai un rapido controllo: quale piano usi? Se hai un progetto Cloud a pagamento senza scadenza il 18 giugno, la migrazione è utile ma non urgente. Se usi Free/Pro/Ultra e hai qualcosa in esecuzione nella CLI, passa ora, mentre i piani sono ancora attivi, così puoi confrontare il comportamento sulla stessa attività.

macOS e Linux

Una riga di comando con curl:

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

Lo script rileva la piattaforma, scarica il binario agy, ne verifica il checksum e lo inserisce in ~/.local/bin. Se questa cartella non è in PATH, aggiungila:

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

Verifica che il binario sia visibile:

which agy
agy --version

Windows (PowerShell)

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

Il binario verrà installato in C:\Users\[your_name]\AppData\Local\agy\bin. L’installer aggiornerà automaticamente PATH, ma apri una nuova finestra di PowerShell per ricaricare le variabili.

Windows (CMD)

Se PowerShell è bloccato dai criteri aziendali:

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

Verificare l’installazione

Dopo l’installazione su qualsiasi sistema operativo, esegui:

agy doctor

Il comando controlla la versione del binario, se esiste una configurazione, l’autenticazione e l’accesso di rete a antigravity.google. Se non riesce a raggiungere Google, il problema riguarda la tua regione o il proxy.

Autenticazione

La prima volta che esegui agy senza argomenti, si avvia una procedura guidata di configurazione:

1. Scegli un tema per l’interfaccia.
2. Scegli un metodo di autenticazione: Google OAuth (per gli account personali) o una chiave API.
3. Facoltativamente, importa subito la configurazione da .gemini/.

Se scegli OAuth, si aprirà un browser che ti reindirizzerà a accounts.google.com; dovrai acconsentire alla condivisione dei dati. Dopodiché, la CLI funzionerà.

Come migrare configurazione e plugin da .gemini a .agents#

Passo dopo passo:

1. agy plugin import gemini

   Esegui il comando da qualsiasi cartella. Migrerà i plugin globali da ~/.gemini/ a ~/.agents/. Per i plugin dell’area di lavoro (accanto al progetto), esegui il comando nella cartella del progetto.

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

   Sposta le skill rinominando manualmente la cartella. Il formato dei file al suo interno è lo stesso; non serve riscrivere il markdown.

3. agy inspect

   Mostra quali plugin, skill, hook e subagent sono attivi. Confronta l’elenco con quello che avevi in Gemini CLI—non dovrebbe mancare nulla.

4. agy config --edit

   Apre la configurazione nell’editor predefinito ($EDITOR). Se qualcosa non è stato rilevato automaticamente, modificalo manualmente.

5. agy doctor

   Controllo finale: binario, autenticazione, plugin e rete. Se tutti e quattro sono a posto, la migrazione della configurazione è completa.

Lascerei la vecchia cartella .gemini/ al suo posto come backup per un mese, nel caso fosse sfuggito qualcosa. Dopo aver usato Antigravity per una settimana e aver verificato che ci sia tutto, puoi eliminarla.

Se usi AGENTS.md come configurazione universale per tutti gli strumenti AI, non devi toccarlo. Antigravity CLI legge AGENTS.md dalla stessa cartella di Claude Code o Codex.

Quali variabili d’ambiente bisogna cambiare?#

Tabella completa delle sostituzioni:

Se hai GitHub Actions che trasmettono secret, apri Settings -> Secrets -> Actions e rinomina le chiavi. I valori restano gli stessi (la chiave API Google non è cambiata durante la migrazione).

Controlla tutti i posti in cui potrebbe comparire GEMINI_:

# Trova le occorrenze nel progetto
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

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

Dopo averle sostituite, riavvia il terminale e verificane la presenza senza stampare il segreto. Non attivare il tracciamento della shell e non copiare i valori delle chiavi nei log. La sola presenza non dimostra l’autorizzazione: esamina separatamente agy doctor:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY presente\n'
else
    printf 'AV_API_KEY assente o vuota\n'
fi
agy doctor        # dovrebbe mostrare “authorized”

Cosa si rompe più spesso durante la transizione e come risolvere#

Elenco dei problemi iniziali:

1. Server MCP. Se usavi mcp_servers in .gemini/config.json, potrebbero non essere rilevati dopo agy plugin import gemini. Controlla con agy inspect—ci sarà una sezione mcp. Se è vuota o contiene errori, riscrivila manualmente con agy config --edit. Il formato è descritto nella documentazione ufficiale Antigravity (cerca la sezione MCP).

2. Hook personalizzati. Se avevi uno script bash in .gemini/hooks/ che leggeva $GEMINI_API_KEY, smetterà di funzionare. Cerca questi casi: bash

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

   Sostituisci le variabili.

3. CI/CD. In GitHub Actions o GitLab CI, modifica i passaggi che usano il comando gemini in modo che usino agy. Il nome del binario nell’installer potrebbe differire, quindi crea un’astrazione usando la variabile $CLI_CMD.

4. Estensione IDE. L’estensione Gemini Code Assist per VS Code verrà disabilitata insieme alla CLI. Il sostituto è Antigravity IDE (un fork separato di VS Code) oppure AGENTS.md in un altro editor AI.

5. Caricamento con @[file]. Nelle prime build di Antigravity CLI, il comando @src/file.ts per caricare un file nel contesto aveva dei bug. Aggiorna all’ultima versione: agy update.

Se qualcosa di critico si interrompe e non è possibile risolverlo entro un’ora, una soluzione temporanea per il piano Free è restare su Gemini CLI fino al 18 giugno, preparando nel frattempo la migrazione su un ramo separato del repository. Limite di tempo: 14 giorni.

Vale la pena restare con gli strumenti Google dopo il 18 giugno?#

Antigravity 2.0 può essere considerato un’opzione di riserva nei casi in cui il tuo strumento principale (Claude Code o Codex) non sia adatto. Per un’analisi dettagliata dei suoi pregi e difetti, consulta la guida a Google Antigravity 2.0.

Breve riepilogo di cosa fare a seconda della situazione:

Checklist di migrazione in 15 minuti#

1. Installa Antigravity CLI

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

2. Avvia agy e autentica

   Senza argomenti: agy. Scegli OAuth o una chiave API.

3. Importa i plugin da .gemini

   agy plugin import gemini—migra globalmente le estensioni. Eseguilo di nuovo nella cartella del progetto per i plugin dell’area di lavoro.

4. Sposta le skill

   mv .gemini/skills/ .agents/skills/. I contenuti dei file rimangono invariati.

5. Sostituisci le variabili d’ambiente

   In ~/.zshrc/~/.bashrc e nei file .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Riavvia il terminale.

6. Verifica l’installazione

   agy doctor—tutti e quattro gli elementi (binario, autenticazione, plugin, rete) dovrebbero essere a posto.

7. Esegui un’attività di prova

   agy "write a README for the project in the current folder"—controlla che il risultato sia simile a quello prodotto da Gemini CLI.

8. Aggiorna GitHub Actions / GitLab CI

   Cambia il nome del comando e i secret da GEMINI_* a AV_*.

9. Conserva .gemini/ come backup

   Puoi eliminarla 1–2 settimane dopo aver verificato che tutto funzioni.

Infine: il 18 giugno non significa che «tutti i tuoi progetti si bloccheranno». Significa che il canale gratuito verrà disabilitato. L’accesso all’API Cloud a pagamento rimane, il repository Gemini CLI rimane e sono possibili i fork. Se usavi il piano Free, devi decidere prima del 18 giugno; altrimenti, il prossimo gemini "qualcosa" restituirà un errore di autorizzazione.