Google Antigravity CLI (agy): Comenzi și configurare

Antigravity CLI (agy) este agentul de programare ușor, nativ pentru terminal, scris în Go de la Google, din platforma Antigravity 2.0. Construit pentru execuție paralelă a subagenților, izolare prin Git worktree, Agent Skills, plugin-uri și integrări MCP, agy înlocuiește versiunea pentru consumatori a Gemini CLI.

Acest cheat sheet acoperă flag-urile și subcomenzile agy CLI, comenzile slash interactive, scurtăturile de tastatură, configurarea .agents/ și mcp_config.json, precum și pașii de migrare din Gemini CLI.

🔗 Ghiduri asociate: Comparație CLI-uri pentru agenți de programare IA · Cheat sheet Claude Code CLI · Cheat sheet OpenAI Codex CLI · Arhitectura și dezvoltarea AI Agent Skills

1. Instalare, subcomenzi și flag-uri de pornire

1.1 Instalare și lansare

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

# Pornește interfața TUI interactivă (urmează instrucțiunile de autentificare de pe ecran la prima rulare)
agy

1.2 Subcomenzi principale și flag-uri de pornire

Comandă / Flag	Descriere	Exemplu de utilizare
`agy`	Lansează TUI-ul interactiv în spațiul de lucru activ	`agy`
`agy -p "<prompt>"`	Execuție neinteractivă (headless), afișează rezultatul pe stdout și iese	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Lansează o sesiune interactivă preîncărcată cu un prompt inițial	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Reia cea mai recentă sesiune de conversație	`agy -c`
`agy --conversation <id>`	Încarcă o anumită conversație din istoric după ID	`agy --conversation 42a506e6-...`
`--mode <mode>`	Setează modul de permisiune la execuție: `default` · `accept-edits` · `auto` (auto-aprobare în sandbox) · `plan`	`agy --mode accept-edits`
`--model <model>`	Suprascrie modelul activ pentru această sesiune	`agy --model gemini-3.8-flash`
`--effort <level>`	Setează efortul de raționament (`low` până la `max`, dependent de model)	`agy --effort high`
`--agent <agent>`	Atașează un profil personalizat de agent la pornire	`agy --agent reviewer`
`--add-dir <path>`	Acordă contextului spațiului de lucru acces la un director suplimentar (repetabil)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Listează modelele disponibile sau agenții personalizați configurați	`agy models`
`agy plugin <subcmd>`	Gestionează plugin-uri: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Comenzi slash interactive în TUI

Tastează / în interiorul agy pentru a invoca și autocompleta comenzile încorporate:

2.1 Control general, sesiune și istoric

Comandă	Funcție	Note și utilizare
`?` / `/help`	Listează toate comenzile slash și scurtăturile de tastatură disponibile	Referință rapidă în timpul sesiunii
`/config` / `/settings`	Deschide interfața interactivă de setări pe tot ecranul	Editează preferințele, temele și permisiunile (`settings.json`)
`/clear`	Golește buffer-ul promptului activ și pornește o sesiune nouă	Trecere curată la o sarcină fără legătură
`/compact`	Comprimă și rezumă istoricul conversației	Recuperează spațiu de context în rulările lungi
`/resume`	Deschide selectorul de conversații pentru a restaura sesiuni anterioare	Continuă fluxurile de lucru întrerupte
`/rewind` / `/undo`	Dă înapoi pas cu pas prin turele conversației	Anulează ture sau direcții greșite
`/fork`	Ramifică conversația în punctul de control curent	Explorează în siguranță ramuri paralele ale spațiului de lucru
`/exit` / `/quit`	Închide sesiunea `agy` CLI	Sau apasă `Ctrl + D Ctrl + D`

2.2 Modele, fluxuri de lucru, agenți și extensii

Comandă	Funcție	Note și utilizare
`/model`	Schimbă modelul IA activ în timpul sesiunii	Echilibrează viteza/costul față de puterea de raționament
`/effort`	Inspectează sau setează efortul de raționament (`low` până la `max`)	Notă: `agy -p "/effort"` oferă ieșire JSON doar pentru citire
`/plan`	Generează un plan pas cu pas înainte de modificarea fișierelor	Barieră de siguranță înaintea schimbărilor ample de arhitectură
`/goal`	Rulează autonom până la finalizare fără pauze intermediare	Potrivit pentru sarcini pe orizont lung
`/grill-me`	Desfășoară un interviu interactiv de cerințe înainte de a scrie cod	Clarifică din start cazurile limită și criteriile de acceptare
`/agent`	Comută sau invocă profiluri personalizate de subagenți/agenți	Încarcă definiții din `.agents/agents/`
`/worktree`	Creează sau gestionează directoare izolate Git worktree	Lucrează pe ramuri paralele fără a polua arborele principal
`/mcp`	Inspectează starea live a conexiunii MCP, logurile și reîncarcă configurarea	Depanează servere MCP locale sau remote
`/plugin`	Navighează, activează, dezactivează sau inspectează plugin-uri Marketplace	Gestionează skills, reguli, hook-uri și servere MCP incluse
`/voice`	Comută modul de introducere prin dictare vocală	Echivalent scurtătură: `F5`

3. Scurtături de tastatură în terminal și sintaxă de intrare

Scurtătură / Sintaxă	Acțiune	Efect și scenariu
`@<path>`	Completare automată a căii fișierului	Injectează în context căi specifice de fișiere sau directoare
`!<command>`	Execuție inline în terminal	Prefixază cu `!` pentru a rula comenzi shell direct (ex.: `!npm run build`)
`Ctrl + G`	Deschide editorul extern	Scrie prompturi lungi sau pe mai multe linii în editorul implicit (Vim, VS Code)
`Esc Esc`	Golește caseta activă de prompt	Șterge intrarea în așteptare când niciun flux nu este activ
`F5`	Comută dictarea vocală	Echivalent cu `/voice`
`Ctrl + D Ctrl + D`	Închide sesiunea	Apasă de două ori `Ctrl + D` pentru a ieși curat

4. Ierarhia configurării și `mcp_config.json`

4.1 Harta directoarelor globale vs. spațiu de lucru

Strat	Domeniu global (toate spațiile de lucru)	Domeniu spațiu de lucru (local proiectului)	Scop
Setări CLI	`~/.gemini/antigravity-cli/settings.json`	—	Preferințe CLI, temă, editor și permisiuni implicite
Scurtături tastatură	`~/.gemini/antigravity-cli/keybindings.json`	—	Mapări personalizate de taste în terminal
Instrucțiuni proiect	`~/.gemini/AGENTS.md` sau `GEMINI.md`	`./AGENTS.md` sau `./GEMINI.md`	Convenții persistente ale repo-ului, comenzi build/test, persona
Reguli mereu active	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Constrângeri de fundal injectate automat în context
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Pachete modulare Agent Skills cu scripturi și resurse
Configurare MCP	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Definiții de servere MCP locale (stdio) și remote (HTTP)

⚠️ Schemă incompatibilă pentru MCP remote (serverUrl): În mcp_config.json, serverele MCP HTTP remote trebuie să folosească serverUrl în locul cheilor vechi url sau httpUrl — folosirea url provoacă eșecuri silențioase de conectare.

{
  "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. Migrarea de la vechiul Gemini CLI la `agy`

Nivelul gratuit pentru consumatori și cererile Google AI Pro/Ultra pe Gemini CLI s-au încheiat pe 18 iunie 2026 (rămânând doar Gemini Code Assist enterprise și fluxurile contorizate prin cheie API). Mapările esențiale de migrare către agy:

Componentă	Vechiul Gemini CLI	Antigravity CLI (`agy`)	Acțiune de migrare
Runtime și binar	TypeScript open-source (`gemini`)	CLI multi-agent în Go (`agy`)	Schimbă invocările la `agy`; configurarea inițială rulează automat la pornire
Extensii	Extensii Gemini CLI	Plugin-uri native Antigravity	Rulează `agy plugin import gemini` pentru conversie și import
Fișiere de instrucțiuni	`GEMINI.md`	`GEMINI.md` și `AGENTS.md`	Complet compatibil — fișierul `GEMINI.md` existent funcționează neschimbat
Cale locală Skills	`.gemini/skills/`	`.agents/skills/`	Mută folderele de skill-uri în `.agents/skills/<name>/SKILL.md`
Fluxuri vechi (Workflows)	`.agents/workflows/`	Migrat la Agent Skills	Convertește workflow-urile cu un singur fișier în `.agents/skills/` (`/migrate-workflows`)
Config și chei MCP	Inline în `settings.json` folosind `url`	`mcp_config.json` dedicat folosind `serverUrl`	Separă blocurile MCP în `mcp_config.json` și redenumește `url` în `serverUrl`

Google Antigravity CLI (agy): Comenzi și configurare — Cheat sheet

1. Instalare, subcomenzi și flag-uri de pornire

1.1 Instalare și lansare

1.2 Subcomenzi principale și flag-uri de pornire

2. Comenzi slash interactive în TUI

2.1 Control general, sesiune și istoric

2.2 Modele, fluxuri de lucru, agenți și extensii

3. Scurtături de tastatură în terminal și sintaxă de intrare

4. Ierarhia configurării și `mcp_config.json`

4.1 Harta directoarelor globale vs. spațiu de lucru

5. Migrarea de la vechiul Gemini CLI la `agy`

Subiecte conexe

1. Instalare, subcomenzi și flag-uri de pornire

1.1 Instalare și lansare

1.2 Subcomenzi principale și flag-uri de pornire

2. Comenzi slash interactive în TUI

2.1 Control general, sesiune și istoric

2.2 Modele, fluxuri de lucru, agenți și extensii

3. Scurtături de tastatură în terminal și sintaxă de intrare

4. Ierarhia configurării și mcp_config.json

4.1 Harta directoarelor globale vs. spațiu de lucru

5. Migrarea de la vechiul Gemini CLI la agy

Subiecte conexe

Referințe conexe

4. Ierarhia configurării și `mcp_config.json`

5. Migrarea de la vechiul Gemini CLI la `agy`