Référence des commandes · Cursor CLI
agent create-chat
Crée un nouveau chat vide et renvoie son ID, par ex. pour un usage dans des scripts.
agent create-chat crée une nouvelle session de chat vide et affiche uniquement son ID de chat dans la console, sans ouvrir de session interactive ni envoyer de prompt. La commande convient donc aux scripts et automatisations qui veulent d'abord réserver un identifiant de session pour ensuite le cibler précisément. L'ID renvoyé peut être repris avec l'option globale --resume [chatId], par exemple pour envoyer des prompts vers cette session précise depuis un processus ou un script séparé. Cela distingue la commande de agent ls, qui liste les chats existants de tous les workspaces, et de agent resume, qui, sans indication d'ID, reprend directement la dernière session active. create-chat appartient à la même famille de commandes que login, logout, status et models, toutes documentées via agent help [command].
✅ QUAND L’UTILISER ?
Réserver au préalable un ID de session pour le cibler plus tard depuis un script via --resume
CHAT_ID=$(agent create-chat); agent --resume "$CHAT_ID" -p "start task"
Créer à l'avance plusieurs ID de chat indépendants avant de répartir des prompts
for i in 1 2 3; do agent create-chat; done > chat-ids.txt
⛔ QUAND ÉVITER ?
Se lancer directement et discuter immédiatement avec l'agent
agent create-chat crée seulement une session vide, mais n'envoie aucun prompt et ne démarre aucune conversation.
Mieux: utiliser simplement agent ou agent "<prompt>"
Retrouver et reprendre une session antérieure
create-chat génère toujours un nouvel ID de chat vide au lieu de rechercher une session existante.
Mieux: utiliser agent ls pour lister, ou agent resume pour la dernière session active
SOURCES
- Cursor Docs — CLI Reference: Parameters ↗ cursor.com
AUTRES COMMANDES · Cursor CLI