promptgarten đŸŒ±
🌍 ZH

Référence des commandes · Cursor CLI

Global Options (Flags)

Rassemble les flags globaux les plus importants de la CLI Cursor, combinables avec n'importe quelle commande.

Les options globales peuvent ĂȘtre combinĂ©es avec n'importe quelle commande (agent, agent mcp list, agent sandbox run, ...). Les plus importantes : -p, --print : mode non interactif, affiche la rĂ©ponse dans la console (pour scripts/CI) ; a un accĂšs complet Ă  l'Ă©criture et au shell --output-format <format> : text (par dĂ©faut), json ou stream-json — fonctionne uniquement avec --print --model <model> : dĂ©finit le modĂšle Ă  utiliser --mode <mode> : plan ou ask (par dĂ©faut, le mode agent complet s'applique sans ce flag) ; --plan est un raccourci pour --mode=plan -f, --force (alias --yolo) : autorise automatiquement les commandes sauf interdiction explicite — saute les demandes de confirmation --sandbox <mode> : enabled ou disabled --approve-mcps : approuve automatiquement tous les serveurs MCP configurĂ©s --trust : fait confiance au workspace sans demander (pertinent seulement en mode headless/print) --add-dir <path> : ajoute un rĂ©pertoire supplĂ©mentaire pour une session multi-racine au dĂ©marrage (changelog uniquement) --auto-review : active le mode d'exĂ©cution auto-review, un classificateur dĂ©cide des autorisations au lieu d'une liste blanche fixe (changelog uniquement) --image : joint une image Ă  la session (changelog uniquement) -w, --worktree [name] : exĂ©cute l'agent dans un nouveau Git worktree au lieu d'Ă©diter directement le checkout en cours --resume [chatId] / --continue : reprend une session de chat existante ou la plus rĂ©cemment utilisĂ©e --workspace <path> : dĂ©finit le rĂ©pertoire de projet Ă  utiliser -h, --help : affiche l'aide de la commande concernĂ©e

✅ QUAND L’UTILISER ?

Utiliser -p dans des scripts et des pipelines CI

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

Combiner plusieurs flags de façon ciblée plutÎt que de choisir un mode inutilement large

agent -p --mode ask "summarize the auth module" — lecture seule, sortie structurĂ©e pour un script

⛔ QUAND ÉVITER ?

Définir --force ou --yolo par défaut à chaque exécution, sans vérifier les modifications

cela autorise aussi automatiquement des commandes risquées sans que personne ne les voie au préalable

Mieux: relire les modifications aprÚs l'exécution de façon ciblée (Ctrl+R ou /changes), ou définir en plus --sandbox enabled pour au moins isoler l'exécution

Définir --mode ask mais attendre ensuite des modifications de fichiers

en mode ask, l'agent n'effectue aucune modification de fichier ; un script qui attend ensuite un accÚs en écriture ne trouvera rien

Mieux: utiliser le mode agent par défaut (sans flag --mode) pour les exécutions nécessitant des modifications de fichiers, ou --plan pour planifier au préalable

SOURCES