agent sandbox run <cmd> [args...]

Exécute une seule commande dans un sandbox avec accès lecture/écriture au workspace.

agent sandbox run <cmd> [args...] exécute exactement une commande isolément, par défaut avec accès lecture/écriture au workspace (--sandbox, vrai par défaut) et sans accès réseau (--network, faux par défaut). Des chemins supplémentaires peuvent être exposés via --allow-paths ou --readonly-paths, et des fichiers indésirables bloqués via --blocked-patterns (syntaxe gitignore) ; --sb-debug écrit des logs de debug dans un dossier temporaire.

🎬 EN VIDÉO COURTE

Exécute une seule commande dans un sandbox avec accès lecture/écriture au workspace.

✅ QUAND L’UTILISER ?

Tester isolément un script d'installation/build inconnu avant qu'il ne touche le vrai workspace

agent sandbox run npm install

Exécuter une commande avec accès réseau alors que le sandbox le bloque autrement

agent sandbox run --network curl https://example.com/healthz

⛔ QUAND ÉVITER ?

Plusieurs commandes doivent tourner isolées durablement, pas seulement une

agent sandbox run est prévu pour exactement une seule commande

Mieux: utiliser agent sandbox enable pour que la politique sandbox s'applique à toutes les futures commandes exécutées par la CLI

La commande a besoin d'un accès en dehors du répertoire workspace

sans flags supplémentaires, l'accès est limité au workspace

Mieux: indiquer --allow-paths ou --readonly-paths avec les chemins supplémentaires nécessaires

SOURCES

Cursor Docs — CLI Reference: Parameters ↗ cursor.com