1. Introduzione
In questo codelab, imparerai a utilizzare Antigravity CLI, una TUI (Terminal User Interface) leggera di Antigravity. Offre le stesse capacità agentiche di Antigravity (come il ragionamento multi-step, la modifica di più file, la chiamata di strumenti e la cronologia delle conversazioni) direttamente nel terminale.
Cosa imparerai a fare
- Installazione e configurazione di Antigravity CLI
- Informazioni sull'utilizzo di base di Antigravity CLI
- Esplorare alcuni casi d'uso con Antigravity CLI
Che cosa ti serve
Ti serviranno:
- Browser web Chrome
- Un account Gmail personale
Questo codelab è progettato per utenti e sviluppatori di tutti i livelli (inclusi i principianti). I casi d'uso nel codelab sono stati suddivisi in attività per sviluppatori e non sviluppatori. I casi d'uso degli sviluppatori mostrano come vibrare il codice con Antigravity CLI e come lavorare con un repository GitHub per eseguire attività di sviluppo comuni come la spiegazione/comprensione del codice, la generazione di documentazione, la correzione di problemi e altro ancora. Ti consigliamo di completare questi casi d'uso nel codelab. Alla fine è presente una sezione facoltativa che copre diverse attività quotidiane non incentrate sugli sviluppatori.
2. Installazione
Prima di eseguire la configurazione ed eseguire l'interfaccia a riga di comando Antigravity, creiamo una cartella che utilizzeremo come cartella principale per tutti i progetti che creiamo al suo interno. Questo è un punto di partenza per l'utilizzo dell'interfaccia a riga di comando Antigravity, anche se farà riferimento anche ad altre cartelle del sistema, che verranno utilizzate in un secondo momento, se necessario.
Crea una cartella di esempio (agy-cli-projects) e vai alla cartella tramite i comandi mostrati di seguito. Se preferisci utilizzare un altro nome per la cartella, fallo pure.
mkdir agy-cli-projects
Andiamo a questa cartella:
cd agy-cli-projects
L'installazione è semplice e i file binari sono disponibili per i principali sistemi operativi. Ho preso i comandi da eseguire nel terminale direttamente dal documento di installazione:
macOS | Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex
Windows CMD
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
Idealmente, dovrebbe configurare e installare l'interfaccia a riga di comando Antigravity (agy) nel sistema e nel percorso.
In alcuni casi, se il programma di installazione non è in grado di aggiungere il file binario ( agy al PATH), lo comunicherà. Ad esempio, ecco un output di esempio su una macchina in cui il programma di installazione non è riuscito ad aggiungere il file binario al PATH e ha suggerito cosa fare.
% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.
Controlla la versione di Antigravity CLI tramite il seguente comando (la versione mostrata è quella al momento della stesura di questo codelab):
$ agy --version
1.0.7
Quando avviamo Antigravity CLI per la prima volta, ti verrà chiesto di accedere. Avvia agy e dovrebbe essere visualizzato un messaggio simile a questo:
▄▀▀▄
▀▀▀▀▀▀
▀▀▀▀▀▀▀▀
▄▀▀ ▀▀▄
▄▀▀ ▀▀▄
Welcome to the Antigravity CLI. You are currently not signed in.
Select login method:
> 1. Google OAuth
2. Use a Google Cloud project
[Use arrow keys to navigate, Enter to select]
Per il momento, utilizza il tuo account personale. Scegli 1. Google OAuth e premi Invio. Verrà avviato un browser e potrai accedere con il tuo Account Google. Una volta completate l'autenticazione e l'autorizzazione, ti viene chiesto di copiare un codice. Torna al terminale della CLI Antigravity e incolla il codice.
Una volta eseguito l'accesso, si verificano alcune cose:
- Innanzitutto, ti chiede il tema cromatico che vuoi scegliere per Antigravity CLI, come mostrato di seguito. Scegli quello che ti piace di più.
- Dopodiché, devi accettare alcuni Termini di servizio. Accettali.
Infine, la cosa più importante è concedere l'autorizzazione per la cartella, come mostrato di seguito:
Accessing workspace:
/Users/yourusername/agy-cli-projects
Do you trust the contents of this project?
Antigravity CLI requires permission to read, edit, and execute files here.
> Yes, I trust this folder
No, exit
↑/↓ Navigate · enter Confirm
In genere, questa cartella viene visualizzata in qualsiasi nuova cartella in cui avvii l'interfaccia a riga di comando Antigravity. Ne parleremo più avanti nella serie, ma per ora seleziona Sì, mi fido di questa cartella.
Complimenti! Ora è tutto pronto e Antigravity CLI attende il tuo prompt.
3. La nostra prima interazione con Antigravity CLI
Iniziamo a utilizzare Antigravity CLI e digitiamo la prima query come mostrato di seguito:
Give me a famous quote on Artificial Intelligence and who said that?
Riceviamo una risposta di esempio come mostrato di seguito:
Here is a famous quote on Artificial Intelligence:
│ "Artificial intelligence is the new electricity."
│ — Andrew Ng
Oltre a fornire prompt qui, quali sono i vari comandi supportati dalla CLI Antigravity? Puoi trovarlo digitando /help (barra). Verranno visualizzate tre schede : Generale, Comandi e Scorciatoie. Per impostazione predefinita, viene visualizzata la scheda Generale e puoi utilizzare il tasto Tab per passare a Comandi, dove vedrai una serie di comandi. Puoi anche accedere alle scorciatoie da tastiera.
L'elenco dei comandi al momento della stesura è riportato di seguito:
Nota: puoi uscire da Antigravity CLI in qualsiasi momento tramite il comando /quit oppure puoi eseguire ctrl+d due volte nella sessione del terminale interattivo di Antigravity CLI.
4. Antigravity CLI - a few housekeeping commands
Assicurati che Antigravity CLI sia in esecuzione e in attesa del tuo comando. Se hai provato il comando /quit alla fine della sezione precedente, avvia di nuovo l'interfaccia a riga di comando Antigravity tramite il comando agy.
Nota il modello che utilizza, il cui nome verrà visualizzato in basso a destra. La prima cosa da fare è capire che la maggior parte delle personalizzazioni e delle impostazioni che devi eseguire sono disponibili tramite il comando /config o /settings.
Configurazione / Impostazioni
Procedi e richiama il comando /config. Verranno visualizzate varie aree di Antigravity che puoi personalizzare in base alle tue preferenze. Sono inclusi la combinazione di colori, l'autorizzazione degli strumenti, le impostazioni di telemetria e altro ancora.
Settings
Search:
────────────────────
> Animation Speed medium
Artifact Review asks for review
Color Scheme dark
Editor auto ($EDITOR)
Enable Telemetry on
Non-Workspace Access off
Notifications off
Rendering Mode native terminal (inline)
Sandbox Mode off
Show Feedback Survey on
Show Tips on
Tool Permission request-review
Use AI Credits off
Verbosity high
Ad esempio, la combinazione di colori offre le seguenti opzioni, tra cui posso scegliere la mia preferita:
settings.json
Le impostazioni di configurazione devono essere archiviate da qualche parte, giusto? Tutti vengono archiviati nel file ~/.gemini/antigravity-cli/settings.json. Di seguito è riportato un esempio:
{
"colorScheme": "dark",
"model": "Gemini 3.5 Flash (High)",
"statusLine": {
"type": "",
"command": "",
"enabled": true
},
"trustedWorkspaces": [
"/Users/romin/antigravity-cli-projects",
"/Users/romin/agy-cli-projects"
]
}
Puoi notare il colorScheme che ho selezionato, il modello e anche varie cartelle da cui ho avviato Antigravity CLI e ho accettato di considerare attendibili le cartelle.
Nota: puoi modificare direttamente anche settings.json e riavviare Antigravity CLI come best practice per visualizzare le modifiche. Assicurati però che le impostazioni siano corrette, altrimenti verrà visualizzato un errore all'avvio. Se non ti senti a tuo agio a modificare direttamente il file, ti consigliamo di utilizzare il comando /settings o /config nell'interfaccia a riga di comando di Antigravity per lavorare con questo file.
Autorizzazione strumento
Un'impostazione importante da comprendere è l'autorizzazione dello strumento. Controlla se i comandi del terminale richiedono la tua approvazione prima dell'esecuzione. Puoi accedere a questa funzionalità tramite il comando /config.
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
Per impostazione predefinita, è impostato su request-review. Vediamo questo aspetto più nel dettaglio. In Antigravity, le impostazioni di autorizzazione dello strumento controllano l'equilibrio tra sicurezza (protezione del sistema host da modifiche indesiderate) e velocità (il livello di autonomia con cui l'agente può lavorare senza interrompersi per ricevere il tuo input). Esaminiamo le opzioni:
request-review (valore predefinito attuale)
In questa modalità, l'agente viene trattato come un partner collaborativo che esegue il check-in prima di eseguire qualsiasi azione che potrebbe influire sui file di sistema o di progetto al di fuori dei limiti preapprovati. Ogni volta che l'agente tenta di eseguire un comando del terminale, eseguire un'operazione sui file (come scrittura/eliminazione) o chiamare un servizio esterno per il quale l'autorizzazione non è stata pre-approvata, l'esecuzione viene sospesa. All'utente viene chiesto di approvare o rifiutare l'azione specifica.
proceed-in-sandbox
Questa modalità consente all'agente di eseguire automaticamente i comandi del terminale, ma all'interno di un container sicuro e isolato. L'agente può eseguire comandi senza chiederti, ma questi comandi vengono eseguiti in una sandbox virtualizzata (ad es. un container leggero). Non possono modificare il file system della macchina host effettiva o accedere alla tua rete locale.
always-proceed
Questa è la modalità completamente autonoma, che offre all'agente la massima velocità e capacità. All'agente viene concessa l'autorizzazione completa per eseguire comandi e scrivere file direttamente sulla macchina host. Non ti verrà mai chiesto di confermare.
strict
Si tratta di una modalità Zero Trust ad alta sicurezza. Le funzionalità dell'agente sono limitate all'esecuzione di strumenti di lettura. Tutti gli strumenti non di lettura richiederanno all'utente di eseguire un'azione.
5. Antigravity CLI - Command Parameters
Esistono alcuni parametri della riga di comando che è possibile fornire quando avvii l'interfaccia a riga di comando Antigravity. Per visualizzare un elenco completo delle opzioni, puoi utilizzare --help come mostrato di seguito.
agy --help
Dovrebbe essere visualizzata la gamma completa di opzioni disponibili. Di seguito è riportato un esempio di scheda:
Diamo un'occhiata ad alcuni.
Modalità non interattiva (autonoma)
Un'opzione interessante è eseguire Antigravity CLI in modalità non interattiva. Ciò significa che fornisci direttamente il prompt e il modello risponderà senza aprire il terminale interattivo di Antigravity CLI. Ciò è molto utile se prevedi di utilizzare Antigravity CLI in modo automatico nell'ambito dello script o di qualsiasi altro processo di automazione.
Utilizza il parametro -p per fornire il prompt ad Antigravity CLI come mostrato di seguito:
agy -p "What is the gcloud command to deploy to Cloud Run"
Questo potrebbe essere un buon modo per ottenere risposte rapide, ma tieni presente che non è possibile continuare la conversazione con domande aggiuntive.
Scegliere un modello specifico
Il primo è chiedere ad Antigravity CLI di utilizzare una modalità Gemini specifica. Puoi utilizzare il parametro --model per indicare ad Antigravity CLI di utilizzare un modello specifico solo durante la sessione. Ciò è molto utile per la modalità non interattiva che abbiamo menzionato nella sezione precedente, in cui vuoi avviare diverse sessioni agy e utilizzare modelli specifici per attività specifiche.
Prima di tutto, devi sapere quali modelli sono disponibili per Antigravity CLI. Puoi farlo tramite il sottocomando models come mostrato di seguito:
agy models
Verrà visualizzato un elenco dei modelli disponibili per l'interfaccia a riga di comando Antigravity. Di seguito è riportato un elenco di esempio:
- Gemini 3.5 Flash (Medium)
- Gemini 3.5 Flash (High)
- Gemini 3.5 Flash (Low)
- Gemini 3.1 Pro (basso)
- Gemini 3.1 Pro (alta)
- Claude Sonnet 4.6 (in fase di valutazione)
- Claude Opus 4.6 (in fase di elaborazione)
- GPT-OSS 120B (Medium)
Puoi utilizzare uno qualsiasi di questi nomi di modelli per specificare il modello da utilizzare per la sessione. Puoi farlo tramite il comando --model mostrato di seguito:
agy --model "Gemini 3.5 Flash (Low)"
Una volta avviata Antigravity CLI, puoi controllare il modello specifico che hai chiesto di utilizzare tramite il comando /model o guardare in basso a destra, dove viene visualizzato il modello utilizzato per la sessione.
Vivere pericolosamente
Se ti piace vivere al limite, puoi cercare un parametro dal nome molto appropriato chiamato --dangerously-skip-permissions. In questo modo verranno approvate automaticamente tutte le autorizzazioni degli strumenti. Non verrà visualizzato alcun messaggio che ti chiede le autorizzazioni. Quindi, usalo con attenzione.
Avvia Antigravity CLI con il seguente comando:
agy --dangerously-skip-permissions
Poi, dai il seguente prompt. Controlla che non mi abbia chiesto autorizzazioni di scrittura dei file.
> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.
● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)
▸ Thought for 2s, 95 tokens
Processing News Information
● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)
I have fetched the latest world news headlines and created the requested files in your workspace:
1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S.
security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.
2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.
Questa modalità può essere utile in scenari in cui le cose sono locali e sotto il tuo controllo, ma preparati comunque a sorprese e quindi usala con cautela.