agent create-chat
Erstellt einen neuen, leeren Chat und gibt dessen ID zurück, z.B. für Skripte.
agent create-chat legt eine neue, leere Chat-Session an und gibt ausschließlich deren Chat-ID auf der Konsole aus, ohne eine interaktive Sitzung zu öffnen oder einen Prompt zu senden. Der Befehl eignet sich damit für Skripte und Automatisierungen, die zuerst eine Session-ID reservieren und diese anschließend gezielt ansprechen wollen. Die zurückgegebene ID lässt sich mit der globalen Option --resume [chatId] wieder aufgreifen, etwa um aus einem separaten Prozess oder Skript heraus Prompts in genau diese Session zu schicken. Das unterscheidet den Befehl von agent ls, das vorhandene Chats aus allen Workspaces auflistet, und von agent resume, das ohne Angabe einer ID direkt die zuletzt aktive Session fortsetzt. create-chat gehört zur selben Befehlsfamilie wie login, logout, status und models, die alle über agent help [command] dokumentiert sind.
✅ WANN EINSETZEN?
Vorab eine Session-ID reservieren, um sie später aus einem Skript per --resume anzusprechen
CHAT_ID=$(agent create-chat); agent --resume "$CHAT_ID" -p "start task"
Mehrere unabhängige Chat-IDs vorab anlegen, bevor Prompts verteilt werden
for i in 1 2 3; do agent create-chat; done > chat-ids.txt
⛔ WANN EHER NICHT?
Direkt loslegen und sofort mit dem Agenten chatten
agent create-chat legt nur eine leere Session an, sendet aber keinen Prompt und startet keine Konversation.
Besser: Einfach agent bzw. agent "<prompt>" nutzen
Eine frühere Session wiederfinden und fortsetzen
create-chat erzeugt immer eine neue, leere Chat-ID statt eine bestehende zu suchen.
Besser: agent ls zum Auflisten oder agent resume für die zuletzt aktive Session nutzen
QUELLEN
- Cursor Docs — CLI Reference: Parameters ↗ cursor.com
WEITERE BEFEHLE · Cursor CLI