agent worker în Cursor IDE

agent worker start|debug [opțiuni]

Ce face agent worker

agent worker start pornește un worker privat care se conectează la Cursor și rulează agenți pe mașina ta. agent worker debug rulează diagnostice preliminare pentru autentificare, confidențialitate și rutare. Pe Windows, worker-ul cere Git for Windows, inclusiv Git Bash.

Cu --pool, worker-ul se înregistrează pentru alocare dintr-un pool: un singur Cloud Agent îl folosește la un moment dat. --computer-use lasă agenții să controleze desktopul mașinii; pe macOS instalează aplicația ajutătoare Cursor Computer Use dacă e nevoie.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
start	Pornește worker-ul și îl conectează la Cursor.
debug	Diagnostice pentru autentificare, confidențialitate și rutare.
--auth-token-file <path>	Fișierul cu tokenul de autentificare al worker-ului.
--worker-dir <path>	Rădăcina de workspace expusă agenților; repetabilă, prima valoare dă identitatea.
--management-addr <address>	Adresa pentru /healthz, /readyz și /metrics.
--label <key=value>	Etichetă de worker; repetabilă, nu se combină cu --labels-file.
--labels-file <path>	Fișier de etichete JSON sau TOML (sau CURSOR_WORKER_LABELS_FILE).
--idle-release-timeout <seconds>	Cât rămâne conectat după ce devine inactiv; 0 (implicit) dezactivează eliberarea.
--pool	Înregistrare pentru alocare din pool.
--single-use	Alias vechi pentru --pool.
--pool-name <name>	Numele pool-ului; cere --pool; implicit default.
--name <name>	Numele afișat; implicit hostname-ul.
--data-dir <path>	Directorul pentru loguri, artefacte și înregistrări.
--debug	Afișează diagnostice înainte de pornire.
--computer-use	Agenții pot controla desktopul mașinii.
--display <display>	Doar Linux: display-ul X11 pentru --computer-use, de exemplu :0.
--share-desktop [mode]	Doar Linux: view sau view_and_control pentru cei autorizați.
start --verbose	Loguri detaliate la pornire.
debug --json	Raportul de diagnostic în JSON.

Exemple practice

Exemplul 1: Pornirea worker-ului

agent worker start

Exemplul 2: Diagnostic în format JSON

agent worker debug --json

Greșeli frecvente și bune practici

• Folosești --label împreună cu --labels-file. Cele două nu se pot combina.
• Setezi --pool-name fără --pool (sau aliasul vechi --single-use).

Comenzi înrudite

• cursor-cli-parametri
• cursor-cli-acp
• cursor-cli