Google Antigravity CLI (agy): Comandi e Configurazione (Cheat Sheet)

Antigravity CLI (agy) è l'agente di coding leggero basato su Go e nativo per terminale di Google nella piattaforma Antigravity 2.0. Progettato per l'esecuzione parallela di subagenti, isolamento con Git worktree, Agent Skills, plugin e integrazioni MCP, agy sostituisce la versione consumer di Gemini CLI.

Questo cheat sheet copre flag e sottocomandi di agy CLI, comandi slash interattivi, scorciatoie da tastiera, configurazione .agents/ e mcp_config.json, e passaggi di migrazione da Gemini CLI.

🔗 Cheat Sheet correlati: Confronto CLI di coding IA da terminale · Cheat Sheet CLI di Claude Code · Cheat Sheet OpenAI Codex CLI · Architettura delle AI Agent Skill

1. Installazione, sottocomandi e flag di avvio

1.1 Installazione e avvio

# Installa Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Avvia la TUI interattiva (segui i prompt di autenticazione su schermo al primo avvio)
agy

1.2 Sottocomandi principali e flag di avvio

Comando / Flag	Descrizione	Esempio d'uso
`agy`	Avvia la TUI interattiva nel workspace attivo	`agy`
`agy -p "<prompt>"`	Esecuzione non interattiva (headless), stampa l'output su stdout ed esce	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Avvia una sessione interattiva precaricata con un prompt iniziale	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Riprende la sessione di conversazione più recente	`agy -c`
`agy --conversation <id>`	Carica una conversazione storica specifica tramite ID	`agy --conversation 42a506e6-...`
`--mode <mode>`	Imposta la modalità dei permessi di esecuzione: `default` · `accept-edits` · `auto` (approvazione automatica in sandbox) · `plan`	`agy --mode accept-edits`
`--model <model>`	Sovrascrive il modello attivo per questa sessione	`agy --model gemini-3.8-flash`
`--effort <level>`	Imposta il livello di ragionamento (da `low` a `max`, dipendente dal modello)	`agy --effort high`
`--agent <agent>`	Collega un profilo agente personalizzato all'avvio	`agy --agent reviewer`
`--add-dir <path>`	Concede l'accesso al contesto del workspace a una directory aggiuntiva (ripetibile)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Elenca i modelli disponibili o gli agenti personalizzati configurati	`agy models`
`agy plugin <subcmd>`	Gestisce i plugin: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Comandi slash interattivi nella TUI

Digita / all'interno di agy per richiamare e completare automaticamente i comandi integrati:

2.1 Controllo generale, sessione e cronologia

Comando	Funzione	Note e utilizzo
`?` / `/help`	Elenca tutti i comandi slash e le scorciatoie disponibili	Riferimento rapido in sessione
`/config` / `/settings`	Apre la schermata interattiva completa delle impostazioni	Modifica preferenze, temi e permessi (`settings.json`)
`/clear`	Svuota il buffer del prompt attivo e avvia una nuova sessione	Passa in modo pulito a un'attività non correlata
`/compact`	Comprime e riassume la cronologia della conversazione	Recupera margine di contesto nelle esecuzioni lunghe
`/resume`	Apre il selettore delle conversazioni per ripristinare sessioni precedenti	Continua flussi di lavoro interrotti
`/rewind` / `/undo`	Torna indietro passo dopo passo nei turni della conversazione	Ripristina turni o direzioni errate
`/fork`	Dirama la conversazione dal checkpoint corrente	Esplora in sicurezza rami paralleli del workspace
`/exit` / `/quit`	Esce dalla sessione `agy` CLI	Oppure premi `Ctrl + D Ctrl + D`

2.2 Modelli, flussi di lavoro, agenti ed estensioni

Comando	Funzione	Note e utilizzo
`/model`	Cambia il modello IA attivo durante la sessione	Bilancia velocità/costo rispetto alla capacità di ragionamento
`/effort`	Ispeziona o imposta l'effort di ragionamento (da `low` a `max`)	Nota: `agy -p "/effort"` restituisce solo output JSON in sola lettura
`/plan`	Genera un piano passo-passo prima di modificare i file	Controllo di sicurezza prima di ampie modifiche architetturali
`/goal`	Esegue autonomamente fino al completamento senza pause intermedie	Adatto ad attività di lunga durata
`/grill-me`	Avvia un'intervista interattiva sui requisiti prima di scrivere codice	Chiarisce subito casi limite e criteri di accettazione
`/agent`	Cambia o invoca profili personalizzati di subagenti/agenti	Carica le definizioni da `.agents/agents/`
`/worktree`	Crea o gestisce directory Git worktree isolate	Lavora su branch paralleli senza sporcare l'albero principale
`/mcp`	Ispeziona lo stato live delle connessioni MCP, i log e ricarica la config	Diagnostica server MCP locali o remoti
`/plugin`	Sfoglia, abilita, disabilita o ispeziona i plugin del Marketplace	Gestisce skill, regole, hook e server MCP inclusi
`/voice`	Attiva/disattiva la modalità di dettatura vocale	Scorciatoia equivalente: `F5`

3. Scorciatoie da terminale e sintassi di input

Scorciatoia / Sintassi	Azione	Effetto e scenario
`@<path>`	Completamento automatico percorsi	Inserisce nel contesto percorsi specifici di file o directory
`!<command>`	Esecuzione inline nel terminale	Anteponi `!` per eseguire direttamente comandi shell (es. `!npm run build`)
`Ctrl + G`	Apri editor esterno	Scrivi prompt lunghi o multilinea nel tuo editor predefinito (Vim, VS Code)
`Esc Esc`	Svuota la casella prompt attiva	Cancella l'input in sospeso quando non c'è streaming attivo
`F5`	Attiva/disattiva dettatura vocale	Equivalente a `/voice`
`Ctrl + D Ctrl + D`	Esci dalla sessione	Premi due volte `Ctrl + D` per uscire in modo pulito

4. Gerarchia di configurazione e `mcp_config.json`

4.1 Mappa delle directory: ambito globale vs workspace

Livello	Ambito globale (tutti i workspace)	Ambito workspace (locale al progetto)	Scopo
Impostazioni CLI	`~/.gemini/antigravity-cli/settings.json`	—	Preferenze CLI, tema, editor e permessi predefiniti
Scorciatoie da tastiera	`~/.gemini/antigravity-cli/keybindings.json`	—	Mappature personalizzate dei tasti nel terminale
Istruzioni di progetto	`~/.gemini/AGENTS.md` o `GEMINI.md`	`./AGENTS.md` o `./GEMINI.md`	Convenzioni persistenti del repo, comandi build/test, persona
Regole sempre attive	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Vincoli di background iniettati automaticamente nel contesto
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Pacchetti modulari Agent Skills con script e risorse
Configurazione MCP	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Definizioni di server MCP locali stdio e remoti HTTP

⚠️ Schema breaking per MCP remoto (serverUrl): In mcp_config.json, i server MCP HTTP remoti devono usare serverUrl anziché le vecchie chiavi url o httpUrl: l'uso di url causa errori di connessione silenziosi.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. Migrazione da Gemini CLI legacy a `agy`

Il livello gratuito consumer e le richieste Google AI Pro/Ultra su Gemini CLI sono terminati il 18 giugno 2026 (lasciando solo i flussi aziendali Gemini Code Assist e le API key a consumo). Principali corrispondenze per migrare ad agy:

Componente	Gemini CLI legacy	Antigravity CLI (`agy`)	Azione di migrazione
Runtime e binario	TypeScript open-source (`gemini`)	CLI multi-agente basata su Go (`agy`)	Passa alle invocazioni `agy`; l'onboarding automatico parte all'avvio
Estensioni	Estensioni Gemini CLI	Plugin nativi Antigravity	Esegui `agy plugin import gemini` per convertire e importare
File di istruzioni	`GEMINI.md`	`GEMINI.md` e `AGENTS.md`	Pienamente compatibile: i `GEMINI.md` esistenti funzionano così come sono
Percorso locale delle Skill	`.gemini/skills/`	`.agents/skills/`	Sposta le cartelle delle skill in `.agents/skills/<name>/SKILL.md`
Workflow legacy	`.agents/workflows/`	Migrati ad Agent Skills	Converti i workflow a file singolo in `.agents/skills/` (`/migrate-workflows`)
Configurazione MCP e chiavi	Inline in `settings.json` con `url`	`mcp_config.json` dedicato con `serverUrl`	Separa i blocchi MCP in `mcp_config.json` e rinomina `url` in `serverUrl`