Referință: settings.json în Antigravity CLI (agy)

Configurare și Extensibilitate Antigravity CLI 1.4+

Cheile din fișierul de setări al Antigravity CLI, cu tipul și valoarea implicită, după referința oficială; o cheie lipsă folosește valoarea implicită.

Sintaxă & invocare
~/.gemini/antigravity-cli/settings.json

Ce face Referință: settings.json

Fișierul ~/.gemini/antigravity-cli/settings.json se editează din /config sau manual. Cu "$schema": "https://antigravity.google/schemas/v1/settings.json" la început, editoare ca VS Code oferă completare și validare.

Pe lângă cheile din tabel există chei de tip obiect: permissions (reguli allow, ask, deny), statusLine și title (scripturi proprii), sandboxProxy (proxy HTTP pentru comenzile din sandbox), customModelsConfig (modele suplimentare pentru cheia Gemini API) și gcp (salvată la autentificarea cu un proiect Google Cloud). Telemetria se setează doar din /config.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
agentMode (string, "") Modul la pornire: "" (default), "accept-edits", "auto", "plan".
colorScheme (string, "terminal") Tema: light, dark, variantele solarized și colorblind-friendly, tokyo night, terminal.
altScreenMode (string, "default") Folosirea ecranului alternativ: default, always, never.
toolPermission (string, "request-review") Preset de siguranță: request-review, proceed-in-sandbox, always-proceed, strict.
artifactReviewPolicy (string, "asks-for-review") Dacă agentul așteaptă revizuirea artefactelor: asks-for-review, agent-decides, always-proceed.
notifications (boolean, false) Sunet și notificare când agentul are nevoie de tine sau termină.
showTips / showFeedbackSurvey (boolean, true) Sfaturi în timpul generării / sondaje de feedback.
editor (string, "auto") Editorul extern ($EDITOR, apoi vim).
editorMode (string, "default") Editarea promptului: default sau vim.
vimInsertFirst (boolean, false) Pornește în modul Insert din Vim; cere editorMode: "vim".
allowNonWorkspaceAccess (boolean, false) Acces la fișiere din afara spațiului de lucru.
enableTerminalSandbox (boolean, false) Rulează comenzile agentului în sandbox-ul sistemului de operare.
useG1Credits (boolean, false) Folosește creditele AI după epuizarea cotei.
verbosity (string, "medium") Cât detaliu arată TUI-ul: high, medium, low.
runningLightSpeed (string, "medium") Viteza animației de progres: fast, medium, slow, off.
copyOnSelect (boolean, true) În ecranul alternativ, copiază selecția la eliberarea mouse-ului.
hideActiveItems (boolean, false) Ascunde lista subagenților și sarcinilor de sub prompt.
pickerGrouping (string, "none") Selectorul /resume: none sau grouped (pe spații de lucru).
queuedMessages (string, "queue") Mesajele trimise în timpul lucrului: queue sau send-immediately.
clearScrollbackOnResize (boolean, true) În modul inline, golește istoricul terminalului la redesenare.
disableSlashCommands (boolean, false) În headless, nu interpretează comenzile slash (ca --disable-slash-commands).
historySize (integer, 2000) Intrări păstrate în istoricul prompturilor (-1 toate, 0 niciuna).
model (string, "") Modelul ales cu /model.
modelProvider (string, "") "gemini" trimite cererile direct la Gemini API cu GEMINI_API_KEY.
trustedWorkspaces (string[], []) Directoarele marcate ca de încredere; le adaugă CLI-ul.
useTerminalCursor (boolean, false) Folosește cursorul terminalului în locul celui bloc.

Exemple practice

Exemplul 1: Exemplul din documentație

{
 "agentMode": "auto",
 "colorScheme": "tokyo night",
 "altScreenMode": "always",
 "toolPermission": "proceed-in-sandbox",
 "notifications": true,
 "enableTerminalSandbox": true
}

Greșeli frecvente și bune practici

  • Pui serverele MCP sau hook-urile în settings.json. Ele stau în mcp_config.json, respectiv hooks.json.
  • Setezi modelProvider la gemini fără să exporți GEMINI_API_KEY. CLI-ul nu mai pornește până nu setezi cheia sau ștergi setarea.

Comenzi înrudite