Opțiunile și subcomenzile agent (referință) în Cursor IDE

agent [opțiuni globale] [comandă] [argumente]

Ce face Opțiunile și subcomenzile agent (referință)

Opțiunile globale se pot folosi cu orice comandă. Fără comandă, agent pornește în modul Agent interactiv; argumentul opțional este promptul inițial. Toate comenzile acceptă -h, --help.

Subcomenzi: agent (modul implicit), login, logout, status / whoami, about, models, mcp, sandbox, worker, acp, update, ls, resume, create-chat, generate-rule / rule, install-shell-integration, uninstall-shell-integration și help [command]. sandbox și acp sunt ascunse din ajutorul implicit.

status, whoami și about acceptă --format text|json (implicit text).

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
-v, --version	Afișează versiunea.
--api-key <key>	Cheia API pentru autentificare (alternativ, variabila CURSOR_API_KEY).
-H, --header <header>	Adaugă un antet la cererile Agent, în formatul Name: Value; se poate repeta.
-p, --print	Afișează răspunsurile în consolă, pentru scripturi; are acces la toate uneltele, inclusiv scriere și shell.
--output-format <format>	Doar cu --print: text, json sau stream-json (implicit text).
--stream-partial-output	Doar cu --print și stream-json: trimite textul ca fragmente individuale.
--resume [chatId]	Reia o sesiune de chat.
--continue	Continuă sesiunea anterioară (alias pentru --resume=-1).
--model <model>	Modelul folosit.
--mode <mode>	plan sau ask; fără opțiune, modul este agent.
--plan	Pornește în Plan (prescurtare pentru --mode=plan).
--list-models	Listează modelele disponibile.
-f, --force	Permite comenzile, cu excepția celor interzise explicit.
--yolo	Alias pentru --force.
--sandbox <mode>	enabled sau disabled.
--approve-mcps	Aprobă automat toate serverele MCP.
--trust	Are încredere în workspace fără întrebare (doar headless).
--workspace <path>	Directorul de lucru folosit.
--plugin-dir <path>	Încarcă un director local de plugin; se poate repeta.
-w, --worktree [name]	Rulează într-un worktree Git nou, în ~/.cursor/worktrees/<reponame>/<name>; fără nume, se generează unul.
--worktree-base <branch>	Ramura sau ref-ul de bază pentru worktree (implicit HEAD-ul curent).
--skip-worktree-setup	Nu rulează scripturile de setup din .cursor/worktrees.json.
-h, --help	Ajutorul comenzii.

Exemple practice

Exemplul 1: Model anume în modul print

agent -p "find and fix performance issues" --model "gpt-5"

Exemplul 2: Lista modelelor disponibile

agent --list-models

Exemplul 3: Starea autentificării în JSON

agent status --format json

Greșeli frecvente și bune practici

• Dai lui --mode valori ca agent sau debug. Opțiunea acceptă doar plan și ask.
• Folosești --output-format sau --stream-partial-output într-o sesiune interactivă. Ambele cer --print.

Comenzi înrudite

• cursor-cli
• cursor-cli-print
• cursor-cli-worktree
• cursor-cli-utilitare