Referință: flag-urile agy în Antigravity CLI (agy)

agy [flag-uri] ["prompt"]

Ce face Referință: flag-urile agy

Flag-urile de mai jos se dau la pornirea lui agy și configurează doar sesiunea respectivă; setările permanente stau în settings.json. Lista exactă pentru versiunea instalată o vezi cu agy --help.

Pentru --print-timeout, tabelul de referință indică valoarea implicită 0s (așteaptă până se termină tura), iar ghidul modului headless spune că o rulare așteaptă implicit până la cinci minute. Într-un pipeline setează valoarea explicit.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--mode <mod>	Modul de execuție: accept-edits, auto (Preview) sau plan.
--model <model>	Modelul sesiunii (vezi agy models).
--effort <nivel>	Efortul de raționament: low până la max, după model.
--agent <nume>	Agentul sesiunii (vezi agy agents).
--add-dir <cale>	Adaugă un director la spațiul de lucru; repetabil.
-c, --continue	Continuă cea mai recentă conversație din directorul curent.
--conversation <id>	Reia o conversație după ID.
-i, --prompt-interactive <prompt>	Rulează un prompt inițial și rămâne în sesiunea interactivă.
-p, --print, --prompt <prompt>	Rulează un singur prompt în modul headless și afișează răspunsul.
--output-format <format>	Pentru -p: text (implicit), json, stream-json.
--input-format <format>	Pentru -p: text (implicit) sau stream-json (prompturi pe stdin).
--json-schema <schemă>	Schemă JSON (text sau cale) pentru răspuns structurat.
--print-timeout <durată>	Limita de timp a rulării headless.
--disable-slash-commands	În headless, trimite prompturile care încep cu / ca text.
--sandbox	Rulează comenzile în sandbox-ul de terminal.
--dangerously-skip-permissions	Aprobă automat toate cererile de permisiune.
--remote-control	Deschide la pornire o conexiune Remote Control.
--project <id sau nume>	Proiectul sesiunii.
--new-project	Creează un proiect nou pentru sesiune.
--log-file <cale>	Altă cale pentru fișierul de jurnal.
--version	Afișează versiunea instalată.

Exemple practice

Exemplul 1: Sesiune în modul plan, cu un model anume

agy --mode=plan --model gemini-3.8-flash-medium

Exemplul 2: Prompt inițial care rămâne interactiv

agy -i "Explică structura acestui proiect"

Greșeli frecvente și bune practici

• Combini --input-format stream-json cu -p. În acest mod prompturile se citesc doar de pe stdin.
• Folosești --dangerously-skip-permissions pe o mașină care nu e izolată. Preferă reguli permissions.allow precise.

Comenzi înrudite

• agy
• agy-prompt
• agy-modes
• agy-settings