Antigravity CLI (agy) su un server

Dal 18 giugno 2026 Gemini CLI non serve più gli account personali gratuiti, Google AI Pro o Ultra. L'annuncio di Google indirizza questi utenti verso l'Antigravity CLI, agy. Su un server, le parti che richiedono attenzione sono l'accesso senza browser, la scelta tra accesso Google e chiave API, e il modo in cui agy gestisce i permessi quando nessuno è al terminale. Eccole in ordine.

Installare agy

Su Linux o macOS, con il tuo utente normale (non 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

La pagina di installazione ufficiale dice che il binario finisce in ~/.local/bin/agy ed elenca macOS, Linux e Windows. L'installer scarica una build per ogni piattaforma, con build Linux sia per amd64 sia per arm64, quindi un VPS ARM va bene. Aggiungi la riga PATH a ~/.bashrc o ~/.profile così le nuove shell e finestre tmux la recepiscono.

Un'abitudine specifica dei server: agy si aggiorna da solo in background. Su un portatile è comodo. Su una macchina che lasci accesa significa che la versione può cambiare sotto i piedi di una sessione lunga. Maude fissa la versione che installa e disattiva questo comportamento con AGY_CLI_DISABLE_AUTO_UPDATE=1. Se vuoi la stessa prevedibilità, esporta quella variabile nella shell o nella unit che avvia agy.

Il flusso di accesso via SSH

Avvia agy in una sessione SSH e scegli l'accesso con Google. Su un portatile aprirebbe un browser. Via SSH rileva la sessione remota e stampa invece un URL di autorizzazione. Poi:

1. Copia l'URL e aprilo sul telefono o sul portatile.
2. Accedi con l'account Google che usi per Antigravity.
3. Copia il codice che ti dà la pagina e incollalo nel terminale.

Le credenziali vengono salvate nel portachiavi del sistema, che su Linux è il Secret Service. Un VPS spoglio non ha una sessione desktop per sbloccare un portachiavi. Una issue GitHub aperta su agy 1.0.0 segnala un loop di accesso su Linux headless causato proprio da questo, più un bug di fuso orario nel salvataggio di riserva su file. Il workaround dell'autore era GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. Non abbiamo verificato se le versioni attuali ne abbiano ancora bisogno. Se agy ti chiede di accedere di nuovo a ogni avvio, quella issue è il primo posto in cui guardare. Altrimenti, usa la modalità con chiave API.

Per uscire e cancellare il profilo salvato, esegui /logout dentro agy.

Modalità con chiave API per l'headless

Per la CI, una macchina condivisa o qualsiasi server su cui preferisci non tenere una sessione Google, esegui agy con una chiave API Gemini. La documentazione di installazione prevede due passaggi. Prima imposta il provider dei modelli in ~/.gemini/antigravity-cli/settings.json, unendolo al file se esiste già:

{
  "modelProvider": "gemini"
}

Poi rendi disponibile la chiave al processo:

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

Così salti del tutto l'accesso all'account. L'utilizzo viene fatturato a token secondo i prezzi dell'API Gemini invece di essere scalato da un piano Google AI. Tieni la chiave fuori dalla cronologia della shell e fuori dal repository su cui lavora l'agente.

I permessi quando nessuno guarda

È il comportamento sui server che sorprende di più. Nei nostri test su agy 1.2.14, le esecuzioni headless (agy -p …, o la modalità stream-json) non possono fermarsi a chiedere prima di eseguire uno strumento. Un comando o una scrittura su file che richiede un permesso viene negata, e il risultato del turno la elenca come negata. Hai tre modi per far passare il lavoro:

• Regole di autorizzazione. agy le legge da permissions.allow in ~/.gemini/antigravity-cli/settings.json. Le voci sono del tipo "command(npm test)", "write_file(src/app.ts)" o "command(*)". Vengono lette all'avvio.
• Modalità. --mode accept-edits approva automaticamente le modifiche ai file, ma i comandi restano negati. --mode plan pianifica senza agire.
• Nessun controllo. --dangerously-skip-permissions, per una macchina usa e getta. Leggi eseguire agenti con tutti i permessi, in sicurezza prima di ricorrervi.

agy interattivo in un terminale, e Remote Control (vedi sotto), possono fermarsi a chiedere. Questa limitazione riguarda quindi specificamente l'uso headless e tramite script.

Portare con te la configurazione di Gemini CLI

Se ne occupa la guida alla migrazione. In breve, per un server che aveva già Gemini CLI:

• Il primo avvio propone la migrazione. Se agy trova una configurazione di Gemini CLI esistente, mostra una checklist di estensioni e impostazioni globali da convertire.
• Le estensioni diventano plugin. Esegui agy plugin import gemini in qualsiasi momento per convertire le estensioni Gemini in plugin di Antigravity.
• I file di contesto funzionano così come sono. GEMINI.md (nel workspace e in ~/.gemini/GEMINI.md) e AGENTS.md vengono letti senza modifiche.
• I server MCP richiedono una piccola modifica. I server globali stanno in ~/.gemini/config/mcp_config.json, quelli del workspace in .agents/mcp_config.json. Rinomina le vecchie chiavi url/httpUrl in serverUrl.
• Le skill si spostano. Le skill del workspace passano da .gemini/skills/ a .agents/skills/, quelle globali in ~/.gemini/antigravity-cli/skills/. Devi spostarle tu.

Google dice che non c'è ancora piena parità di funzioni, e la guida alla migrazione segnala che alcuni temi personalizzati e ritocchi visivi non vengono trasferiti. Se un flusso di lavoro dipende da un'estensione specifica, testalo dopo l'importazione prima di cancellare la vecchia configurazione.

Il daemon Remote Control o Maude

Google offre un modo ufficiale per raggiungere agy da un altro dispositivo. Secondo la documentazione di Remote Control, puoi avviarlo in tre modi:

• /remote-control dentro una sessione in corso. Il tunnel termina quando quella sessione della CLI si chiude.
• agy --remote-control all'avvio di una sessione. Anche questo tunnel termina quando la sessione si chiude.
• Il daemon headless: agy remote-control start --name my-vps, con agy remote-control status e agy remote-control stop. Registra un servizio di sistema che resta in esecuzione in background.

Lo controlli da una dashboard web in qualsiasi browser, con lo stesso account Google. La documentazione dice che puoi installare la dashboard nella schermata home del telefono per ricevere notifiche push, e che puoi rispondere alle richieste di permesso sia dal terminale sia dall'interfaccia remota. Dice anche che un flag di funzionalità dell'account o dell'organizzazione può bloccarlo.

Se Antigravity è l'unico agente che usi e il flag è attivo per il tuo account, il daemon ufficiale è l'ovvia prima scelta. È gratuito e può chiedere prima di agire.

Gestiscilo dal telefono

Se vuoi agy su un server accanto ad altri agenti, gestito da un'app nativa, Maude è un'opzione. Aggiungi il server, e l'app installa agy in una versione testata e ti fa accedere dal telefono. Puoi usare l'accesso Google con un codice incollato o una chiave API Gemini. Per essere chiari su Antigravity in Maude: poiché Maude gestisce agy in headless, non può fermarsi a chiedere prima di eseguire uno strumento. Maude ti mostra l'azione negata e, se la approvi, aggiunge una regola di autorizzazione e riprova. La pagina dell'agente Antigravity ha i dettagli. Il cambiamento di Gemini CLI in sé, e le altre opzioni a cui le persone sono passate, sono trattati nel nostro articolo sulla chiusura di Gemini CLI.

Domande frequenti

Cosa è cambiato

• 1 ottobre 2026 — Prima pubblicazione. Dettagli su installazione, autenticazione, migrazione e Remote Control verificati sulla documentazione di antigravity.google; il comportamento dei permessi in headless viene dai nostri test su agy 1.2.14.