agent [prompt...]

Démarre la CLI Cursor en mode agent par défaut, éventuellement directement avec un prompt en argument.

agent sans sous-commande démarre une session interactive en mode agent — le mode par défaut avec accès complet aux outils (lecture, écriture, commandes shell, web). Un argument de prompt optionnel est envoyé directement comme premier message, par ex. agent "refactor the auth module to use JWT tokens". Sans argument, une fenêtre de chat vide s'ouvre. Pour les exécutions non interactives (scripts, CI), le flag -p/--print fait en plus n'afficher que la réponse finale.

✅ QUAND L’UTILISER ?

Démarrer directement avec une tâche concrète, sans avoir à la taper ensuite

agent "fix the failing tests in src/auth"

Démarrer une session interactive pour un travail exploratoire sans tâche fixe

agent — puis clarifier objectifs et questions étape par étape dans le chat

⛔ QUAND ÉVITER ?

L'exécution doit tourner sans surveillance dans un script ou un job CI

le mode agent par défaut demande une confirmation interactive avant d'exécuter des commandes, ce qui bloque les exécutions sans surveillance

Mieux: combiner -p avec --force, par ex. agent -p --force "<prompt>" (voir l'entrée collective Global Options)

Seule la lecture/l'analyse est souhaitée, pas de modification de fichiers

le mode par défaut a un accès complet en écriture et au shell

Mieux: définir --mode ask au démarrage, ou utiliser /ask après le démarrage

SOURCES

Cursor Docs — CLI Reference: Parameters ↗ cursor.com
Cursor Docs — CLI Overview ↗ cursor.com