Referencia de comandos · Cursor CLI
Global Options (Flags)
Reúne los flags globales más importantes de la Cursor CLI, combinables con cualquier comando.
Las opciones globales se pueden combinar con cualquier comando (agent, agent mcp list, agent sandbox run, ...). Las más importantes: -p, --print: modo no interactivo, imprime la respuesta en la consola (para scripts/CI); tiene acceso completo de escritura y shell --output-format <format>: text (por defecto), json o stream-json — solo junto con --print --model <model>: fija el modelo a usar --mode <mode>: plan o ask (por defecto es el modo agente completo sin este flag); --plan es la forma abreviada de --mode=plan -f, --force (alias --yolo): permite los comandos automáticamente salvo que estén prohibidos explícitamente — se salta las confirmaciones --sandbox <mode>: enabled o disabled --approve-mcps: aprueba automáticamente todos los servidores MCP configurados --trust: confía en el workspace sin preguntar (solo relevante en modo headless/print) --add-dir <path>: añade al iniciar un directorio adicional para una sesión multi-root (documentado solo en el changelog) --auto-review: activa el modo de ejecución Auto-review, un clasificador decide las aprobaciones en lugar de una allowlist fija (documentado solo en el changelog) --image: adjunta una imagen a la sesión (documentado solo en el changelog) -w, --worktree [name]: ejecuta el agente en un nuevo Git worktree en lugar de editar directamente el checkout actual --resume [chatId] / --continue: retoma una sesión de chat existente o la usada más recientemente --workspace <path>: fija el directorio de proyecto a usar -h, --help: muestra ayuda del comando correspondiente
✅ ¿CUÁNDO USARLO?
Usar -p en scripts y pipelines de CI
agent -p "find and fix performance issues" --model "gpt-5" --output-format json
Combinar varios flags de forma selectiva en lugar de elegir un modo innecesariamente amplio
agent -p --mode ask "summarize the auth module" — solo lectura, dando el resultado estructurado para un script
⛔ ¿CUÁNDO MEJOR NO?
Establecer --force o --yolo por defecto en cada ejecución, sin revisar los cambios
Con eso también se permiten automáticamente comandos arriesgados, sin que nadie los vea antes.
Mejor: Revisar los cambios de forma deliberada después de la ejecución (Ctrl+R o /changes), o además establecer --sandbox enabled para al menos aislar la ejecución
Establecer --mode ask pero esperar después cambios de archivos
En modo Ask el agente no hace cambios de archivos; un script que después espere acceso de escritura no encontrará nada.
Mejor: Usar el modo agente por defecto (sin flag --mode) para ejecuciones con cambios de archivos, o usar --plan para planificar de antemano
FUENTES
- Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com
- Documentación de Cursor — CLI Changelog ↗ cursor.com