promptgarten 🌱
🌍 FR

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