Las opciones globales se pueden usar con cualquier comando:
| Opción | Descripción |
|---|
-v, --version | Muestra la versión |
-a, --api-key <key> | Clave de API para autenticación (también se puede usar la variable de entorno CURSOR_API_KEY) |
-p, --print | Imprime las respuestas en la consola (para scripts o uso no interactivo). Tiene acceso a todas las herramientas, incluidas write y bash. |
--output-format <format> | Formato de salida (solo funciona con --print): text, json o stream-json (predeterminado: stream-json) |
-b, --background | Inicia en modo en segundo plano (abre el selector del compositor al iniciar) |
--fullscreen | Activa el modo de pantalla completa |
--resume [chatId] | Reanuda una sesión de chat |
-m, --model <model> | Modelo a utilizar |
-f, --force | Fuerza permitir comandos salvo que se denieguen explícitamente |
-h, --help | Muestra la ayuda del comando |
| Comando | Descripción | Uso |
|---|
login | Autentícate con Cursor | cursor-agent login |
logout | Cierra sesión y borra la autenticación guardada | cursor-agent logout |
status | Consulta el estado de autenticación | cursor-agent status |
mcp | Administra servidores MCP | cursor-agent mcp |
update|upgrade | Actualiza Cursor Agent a la última versión | cursor-agent update o cursor-agent upgrade |
ls | Reanuda una sesión de chat | cursor-agent ls |
resume | Reanuda la última sesión de chat | cursor-agent resume |
help [command] | Muestra ayuda para el comando | cursor-agent help [command] |
Cuando no se especifica un comando, Cursor Agent se inicia en modo de chat interactivo de forma predeterminada.
| Subcomando | Descripción | Uso |
|---|
login <identifier> | Autentícate con un servidor MCP configurado en .cursor/mcp.json | cursor-agent mcp login <identifier> |
list | Lista los servidores MCP configurados y su estado | cursor-agent mcp list |
list-tools <identifier> | Lista las herramientas disponibles y los nombres de sus argumentos para un MCP específico | cursor-agent mcp list-tools <identifier> |
-h, --help para ver ayuda específica de cada comando.
Al iniciar en el modo chat (comportamiento predeterminado), podés proporcionar un prompt inicial:
Argumentos:
prompt — Prompt inicial para el agente
Todos los comandos admiten la opción global -h, --help para mostrar la ayuda específica del comando. 