agent sandbox, –sandbox și /sandbox în Cursor IDE

agent sandbox <enable|disable|reset|run> ...; agent --sandbox enabled|disabled; /sandbox

Ce face agent sandbox, --sandbox și /sandbox

/sandbox deschide un meniu interactiv în care pornești sau oprești sandbox-ul și setezi accesul la rețea; setările se păstrează între sesiuni. La pornire, --sandbox enabled sau --sandbox disabled alege modul.

Subcomanda agent sandbox (ascunsă din ajutorul implicit) are enable, disable (trece în modul allowlist), reset și run, care rulează o singură comandă în sandbox, cu citire și scriere în workspace. În sandbox run, rețeaua este oprită implicit.

Politica sandbox-ului se poate pune și în ~/.cursor/sandbox.json sau .cursor/sandbox.json, ca în editor.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
enable	Pornește sandbox-ul pentru execuția comenzilor.
disable	Oprește sandbox-ul și folosește modul allowlist.
reset	Readuce configurația sandbox la valorile implicite.
run <cmd> [args...]	Rulează o comandă în sandbox.
--allow-paths <paths>	sandbox run: căi suplimentare cu citire și scriere, separate prin virgulă.
--readonly-paths <paths>	sandbox run: căi suplimentare doar pentru citire.
--blocked-patterns <patterns>	sandbox run: tipare în stil gitignore de blocat.
--sandbox	sandbox run: politica workspace cu citire și scriere (implicit true).
--network	sandbox run: permite rețeaua (implicit false).
--sb-debug	sandbox run: scrie loguri de depanare într-un director temporar și afișează calea.

Exemple practice

Exemplul 1: O comandă în sandbox

agent sandbox run ls

Exemplul 2: Activarea sandbox-ului

agent sandbox enable

Greșeli frecvente și bune practici

• Te aștepți ca sandbox run să aibă rețea. Fără --network, rețeaua e oprită.
• Oprești sandbox-ul ca să scapi de o eroare de permisiune, în loc să adaugi calea cu --allow-paths sau în sandbox.json.

Comenzi înrudite

• cursor-cli-run-everything
• cursor-cli-permisiuni
• cursor-run-modes