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 vacía e imprime su ID en la consola, sin iniciar directamente una sesión interactiva. Ese ID se puede retomar después de forma específica con --resume [chatId], por ejemplo desde un script.

✅ ¿CUÁNDO USARLO?

Reservar de antemano un ID de sesión para referenciarlo más tarde desde un script con --resume

CHAT_ID=$(agent create-chat); agent --resume "$CHAT_ID" -p "start task"

⛔ ¿CUÁNDO MEJOR NO?

Empezar directamente y chatear enseguida con el agente

agent create-chat solo crea una sesión vacía, no inicia ninguna conversación.

Mejor: Usar simplemente agent o agent "<prompt>"

FUENTES

Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com