Autentificarea în agy în Antigravity CLI (agy)

Invocare CLI și Sesiuni Antigravity CLI 1.4+

agy se autentifică la pornire cu contul Google, din keyring sau prin browser; alternative pentru headless sunt cheia Gemini API și Application Default Credentials, iar /logout șterge sesiunea.

Sintaxă & invocare
agy (autentificare la prima pornire)   |   /logout   |   GEMINI_API_KEY + "modelProvider": "gemini"   |   AGY_ADC_AUTH=true

Ce face Autentificarea în agy

Nu există o subcomandă agy login. La pornire, CLI-ul caută un token în keyring-ul sistemului (Apple Keychain, Secret Service pe Linux, Windows Credential Manager); dacă nu găsește, deschide browserul pentru autentificare cu un cont Google personal sau, pentru organizații, Business account → Continue with Google Cloud. Peste SSH, CLI-ul afișează un URL pe care îl deschizi local și îți cere codul primit în browser.

Cu o cheie Gemini API, cererile merg direct la Gemini API, fără sesiune de cont: setezi "modelProvider": "gemini" în settings.json și exporți GEMINI_API_KEY. Doar variabila, fără setare, nu are efect, iar CLI-ul nu citește fișiere .env. GOOGLE_GEMINI_BASE_URL trimite cererile la alt endpoint compatibil. Pentru Google Cloud există și ADC: gcloud auth application-default login, apoi AGY_ADC_AUTH=true.

/logout deconectează contul și șterge tokenii din keyring. Cu autentificare prin cheie API, /logout nu are efect.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
agy Autentificare silențioasă din keyring sau prin browser.
/logout Șterge sesiunea și tokenii salvați.
"modelProvider": "gemini" În settings.json: folosește cheia din GEMINI_API_KEY.
GEMINI_API_KEY Cheia Gemini API, creată în Google AI Studio.
GOOGLE_GEMINI_BASE_URL Alt endpoint compatibil Gemini.
AGY_ADC_AUTH=true Folosește Application Default Credentials (opțional GOOGLE_CLOUD_QUOTA_PROJECT, GOOGLE_CLOUD_LOCATION).

Exemple practice

Exemplul 1: Autentificare cu cheie Gemini API

# în ~/.gemini/antigravity-cli/settings.json: { "modelProvider": "gemini" }
export GEMINI_API_KEY="your-api-key"
agy

Exemplul 2: Application Default Credentials

gcloud auth application-default login --project {GCP_PROJECT}
export AGY_ADC_AUTH=true
agy

Greșeli frecvente și bune practici

  • Pui cheia în GOOGLE_API_KEY sau într-un .env. CLI-ul citește doar GEMINI_API_KEY din mediu.
  • Ștergi GEMINI_API_KEY dar lași modelProvider pe gemini. CLI-ul nu mai pornește; șterge și setarea ca să revii la autentificarea cu cont.
  • Dictarea vocală eșuează după o autentificare veche. Rulează /logout și autentifică-te din nou.

Comenzi înrudite