agent create-chat
创建一个新的空聊天,并返回其 ID,便于在脚本中使用。
agent create-chat 会创建一个新的空聊天会话，并且只在控制台输出该会话的 Chat ID，不会打开交互式会话，也不会发送任何提示。因此这个命令适合用在脚本和自动化流程中：先预留一个会话 ID，之后再有针对性地使用它。返回的 ID 可以通过全局选项 --resume [chatId] 重新调用，例如从一个独立的进程或脚本向这个特定会话发送提示。这使它区别于 agent ls（列出所有工作区中已有的聊天）和 agent resume（不指定 ID 时会直接继续最近活跃的会话）。create-chat 与 login、logout、status 和 models 属于同一个命令家族，都可以通过 agent help [command] 查阅文档。
✅ 什么时候用？
提前预留一个会话 ID，以便之后在脚本中通过 --resume 使用
CHAT_ID=$(agent create-chat); agent --resume "$CHAT_ID" -p "start task"
在分发提示之前，预先创建多个独立的聊天 ID
for i in 1 2 3; do agent create-chat; done > chat-ids.txt
⛔ 什么时候不该用？
想直接开始，立刻与代理对话
agent create-chat 只会创建一个空会话，不会发送提示，也不会开始对话。
更好的选择: 直接使用 agent 或 agent "<prompt>"
想找回并继续之前的某个会话
create-chat 总是创建一个新的空聊天 ID，而不会去查找已有的会话。
更好的选择: 使用 agent ls 列出会话，或使用 agent resume 继续最近活跃的会话
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
更多命令 · Cursor CLI