CLI de Cursor
La CLI de Cursor te permite interactuar directamente con agentes de IA desde la terminal para escribir, revisar y modificar código. Tanto si prefieres una interfaz de terminal interactiva como automatizar la salida para scripts y canalizaciones de CI, la CLI ofrece una potente asistencia de programación justo donde trabajas.
Primeros pasos
# Instalar (macOS, Linux, WSL)curl https://cursor.com/install -fsS | bash# Instalar (Windows PowerShell)irm 'https://cursor.com/install?win32=true' | iex# Iniciar sesión interactivaagentModo interactivo
Inicia una sesión con el agente para describir tus objetivos, revisar los cambios propuestos y aprobar comandos:
# Iniciar una sesión interactivaagent# Iniciar con una instrucción inicialagent "refactor the auth module to use JWT tokens"Modos
La CLI admite los mismos modos que el Editor. Cambia de modo con comandos con barra, atajos de teclado o la opción --mode.
| Modo | Descripción | Atajo |
|---|---|---|
| Agente | Acceso completo a todas las herramientas para tareas de programación complejas | Predeterminado (no se requiere ningún valor para --mode) |
| Plan | Define tu enfoque antes de programar con preguntas aclaratorias | Shift+Tab, /plan, --plan, --mode=plan |
| Ask | Exploración de solo lectura sin realizar cambios | /ask, --mode=ask |
Modo no interactivo
Usa el modo de impresión en escenarios no interactivos, como scripts, canalizaciones de CI o automatización:
# Ejecutar con una instrucción y un modelo específicosagent -p "find and fix performance issues" --model "gpt-5"# Usar con cambios de git para revisiónagent -p "review these changes for security issues" --output-format textTransferencia a un agente en la nube
Envía tu conversación a un agente en la nube para que siga ejecutándose mientras estás ausente. Añade & al inicio de cualquier mensaje:
# Envía una tarea a Cloud Agent durante una conversación& refactor the auth module and add comprehensive testsRetoma las tareas de tu agente en la nube desde la web o el móvil en cursor.com/agents.
Sesiones
Reanuda conversaciones anteriores para conservar el contexto entre varias interacciones:
# Abre conversaciones anteriores y reanuda unaagent ls# Reanuda la conversación más recienteagent resume# Continúa la sesión anterioragent --continue# Reanuda una conversación específicaagent --resume="chat-id-here"Controles del sandbox
Configura la ejecución de comandos con /sandbox o la opción --sandbox <mode> (enabled o disabled). Activa o desactiva el modo sandbox y controla el acceso de red desde un menú interactivo. Los ajustes se conservan entre sesiones.
Solicitud de contraseña de sudo
Ejecuta comandos que requieren privilegios elevados sin salir de la CLI. Cuando un comando requiere sudo, Cursor muestra un aviso seguro y enmascarado para introducir la contraseña. Tu contraseña se envía directamente a sudo a través de un canal IPC seguro; el modelo de IA nunca la ve.
