Referencia de comandos · Cursor CLI
agent create-chat
Crea un chat nuevo y vacío, y devuelve su ID, p. ej. para scripts.
agent create-chat crea una sesión de chat nueva y vacía, y solo muestra en la consola su ID de chat, sin abrir una sesión interactiva ni enviar ningún prompt. El comando resulta útil para scripts y automatizaciones que primero quieren reservar un ID de sesión y luego dirigirse a él de forma específica. El ID devuelto se puede retomar con la opción global --resume [chatId], por ejemplo para enviar prompts a esa sesión exacta desde un proceso o script independiente. Esto diferencia el comando de agent ls, que lista los chats existentes de todos los workspaces, y de agent resume, que sin indicar un ID continúa directamente la última sesión activa. create-chat pertenece a la misma familia de comandos que login, logout, status y models, todos documentados mediante agent help [command].
✅ ¿CUÁNDO USARLO?
Reservar de antemano un ID de sesión para dirigirse a él más tarde desde un script con --resume
CHAT_ID=$(agent create-chat); agent --resume "$CHAT_ID" -p "start task"
Crear varios IDs de chat independientes de antemano, antes de repartir los prompts
for i in 1 2 3; do agent create-chat; done > chat-ids.txt
⛔ ¿CUÁNDO MEJOR NO?
Empezar de inmediato y chatear enseguida con el agente
agent create-chat solo crea una sesión vacía, pero no envía ningún prompt ni inicia una conversación.
Mejor: Usar simplemente agent o agent "<prompt>"
Encontrar y continuar una sesión anterior
create-chat siempre genera un ID de chat nuevo y vacío, en lugar de buscar uno existente.
Mejor: usar agent ls para listar o agent resume para la última sesión activa
FUENTES
- Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com
MÁS COMANDOS · Cursor CLI