CLI
Parámetros
Opciones globales
Las opciones globales se pueden usar con cualquier comando:
| Opción | Descripción |
|---|---|
-v, --version | Muestra el número de versión |
--api-key <key> | Clave de API para la autenticación (también se puede usar la variable de entorno CURSOR_API_KEY) |
-H, --header <header> | Añade una cabecera personalizada a las solicitudes del agente (formato: Name: Value; se puede usar varias veces) |
-p, --print | Imprime las respuestas en la consola (para scripts o uso no interactivo). Tiene acceso a todas las herramientas, incluidas las de escritura y shell. |
--output-format <format> | Formato de salida (solo funciona con --print): text, json o stream-json (predeterminado: text) |
--stream-partial-output | Transmite la salida parcial como deltas de texto individuales (solo funciona con --print y el formato stream-json) |
--resume [chatId] | Reanuda una sesión de chat |
--continue | Continúa la sesión anterior (alias de --resume=-1) |
--model <model> | Modelo que se usará |
--mode <mode> | Establece el Modo Agent: plan o ask (el modo agent se usa de forma predeterminada si no se especifica ninguno) |
--plan | Inicia en modo Plan (abreviatura de --mode=plan) |
--list-models | Enumera todos los modelos disponibles |
-f, --force | Autoriza comandos a la fuerza, salvo que se denieguen explícitamente |
--yolo | Alias de --force |
--sandbox <mode> | Establece el modo sandbox: enabled o disabled |
--approve-mcps | Aprueba automáticamente todos los servidores MCP |
--trust | Confía en el espacio de trabajo sin pedir confirmación (solo en modo sin interfaz gráfica) |
--workspace <path> | Directorio del espacio de trabajo que se usará |
--plugin-dir <path> | Carga un directorio de plugin local (se puede especificar varias veces) |
-w, --worktree [name] | Se ejecuta en un nuevo worktree de Git en ~/.cursor/worktrees/<reponame>/<name>. Si se omite, se genera un nombre. |
--worktree-base <branch> | Rama o referencia en la que se basará el nuevo worktree (predeterminado: HEAD actual) |
--skip-worktree-setup | Omite la ejecución de scripts de configuración del worktree definidos en .cursor/worktrees.json |
-h, --help | Muestra la ayuda del comando |
Comandos
| Comando | Descripción | Uso |
|---|---|---|
agent [prompt...] | Iniciar en Modo Agent (predeterminado) | agent agent "fix the tests" |
login | Autenticarse con Cursor | agent login |
logout | Cerrar sesión y borrar la autenticación almacenada | agent logout |
status | whoami | Consultar el estado de autenticación |
about | Mostrar información sobre la versión, el sistema y la cuenta | agent about |
models | Listar los modelos disponibles para esta cuenta | agent models |
mcp | Gestionar servidores MCP | agent mcp |
sandbox | Configurar el modo sandbox o ejecutar un comando en un sandbox (oculto) | agent sandbox enable |
worker | Iniciar un worker de nube privada que ejecuta agentes en tu entorno | agent worker start |
acp | Iniciar el modo de servidor ACP (comando avanzado y oculto) | agent acp |
update | Actualizar Cursor Agent a la versión más reciente | agent update |
ls | Reanudar una sesión de chat | agent ls |
resume | Reanudar la sesión de chat más reciente | agent resume |
create-chat | Crear un nuevo chat vacío y devolver su ID | agent create-chat |
generate-rule | rule | Generar una nueva regla de Cursor con indicaciones interactivas |
install-shell-integration | Instalar la integración de shell en ~/.zshrc | agent install-shell-integration |
uninstall-shell-integration | Eliminar la integración de shell de ~/.zshrc | agent uninstall-shell-integration |
help [command] | Mostrar la ayuda de un comando | agent help [command] |
agent acp está destinado a clientes ACP personalizados e integraciones avanzadas. No
aparece en la salida de ayuda predeterminada de los comandos.
Si no se especifica ningún comando, Cursor Agent se inicia de forma predeterminada en Modo Agent interactivo.
MCP
Gestiona los servidores MCP configurados para Cursor Agent.
| Subcomando | Descripción | Uso |
|---|---|---|
login <identifier> | Autentícate con un servidor MCP configurado en .cursor/mcp.json o ~/.cursor/mcp.json | agent mcp login <identifier> |
list | Muestra los servidores MCP configurados y su estado | agent mcp list |
list-tools <identifier> | Muestra las herramientas disponibles y los nombres de sus argumentos para un MCP específico | agent mcp list-tools <identifier> |
enable <identifier> | Añade un servidor MCP a la lista local de servidores aprobados | agent mcp enable <identifier> |
disable <identifier> | Desactiva un servidor MCP para que no se cargue ni solicite aprobación | agent mcp disable <identifier> |
Todos los comandos MCP admiten -h, --help para consultar la ayuda específica de cada comando.
Sandbox
Configura el modo sandbox o ejecuta un comando en un entorno aislado.
| Subcomando | Descripción | Uso |
|---|---|---|
enable | Activa el modo sandbox para la ejecución de comandos | agent sandbox enable |
disable | Desactiva el modo sandbox y usa el modo de lista de permitidos | agent sandbox disable |
reset | Restablece la configuración del sandbox a los valores predeterminados | agent sandbox reset |
run <cmd> [args...] | Ejecuta un comando en un entorno aislado con acceso de lectura y escritura al espacio de trabajo | agent sandbox run ls |
help [command] | Muestra la ayuda del comando | agent sandbox help |
| Comando | Opción | Descripción |
|---|---|---|
sandbox run | --allow-paths <paths> | Lista separada por comas de rutas adicionales con acceso de lectura y escritura |
sandbox run | --readonly-paths <paths> | Lista separada por comas de rutas adicionales de solo lectura |
sandbox run | --blocked-patterns <patterns> | Lista separada por comas de patrones de estilo gitignore que se deben bloquear |
sandbox run | --sandbox | Ejecuta con la política de sandbox de lectura y escritura del espacio de trabajo (valor predeterminado: true) |
sandbox run | --network | Activa el acceso de red en el sandbox (valor predeterminado: false) |
sandbox run | --sb-debug | Escribe registros de depuración del sandbox en una carpeta temporal e imprime la ruta |
Todos los comandos de sandbox admiten -h, --help para consultar la ayuda específica de cada comando.
Worker
Inicia un worker de nube privado que se conecta a Cursor y ejecuta agentes en tu entorno.
| Subcomando | Descripción | Uso |
|---|---|---|
start | Inicia el worker y lo conecta a Cursor | agent worker start |
debug | Ejecuta diagnósticos previos del worker privado para autenticación, privacidad y enrutamiento | agent worker debug |
help [command] | Muestra la ayuda del comando | agent worker help |
| Comando | Opción | Descripción |
|---|---|---|
worker | --auth-token-file <path> | Ruta a un archivo que contiene el token de autenticación del worker |
worker | --worker-dir <path> | Raíz del espacio de trabajo que se expondrá a los agentes. Se puede repetir. El primer valor es la identidad de asignación. |
worker | --management-addr <address> | Dirección de escucha para /healthz, /readyz y /metrics |
worker | --label <key=value> | Añade una etiqueta al worker. Se puede usar varias veces. No se puede usar con --labels-file. |
worker | --labels-file <path> | Ruta a un archivo de etiquetas JSON o TOML. También se puede usar CURSOR_WORKER_LABELS_FILE. |
worker | --idle-release-timeout <seconds> | Segundos que el worker puede permanecer conectado tras quedar inactivo. El valor predeterminado 0 desactiva la liberación por inactividad. |
worker | --pool | Registra el worker para asignación de pool. Un agente en la nube reclama el worker a la vez. |
worker | --single-use | Alias heredado de --pool |
worker | --pool-name <name> | Etiqueta de pool para los workers del pool. Requiere --pool o --single-use. El valor predeterminado es default. |
worker | --name <name> | Nombre para mostrar personalizado. El valor predeterminado es el nombre de host de la máquina. |
worker | --data-dir <path> | Directorio base para registros, artefactos y datos de grabación |
worker | --debug | Imprime diagnósticos de depuración del worker antes de iniciar el modo bridge |
worker start | --verbose | Activa registros detallados durante el inicio |
worker debug | --json | Genera el informe de depuración en formato JSON |
Opciones específicas de cada comando
| Comando | Opción | Descripción |
|---|---|---|
status, whoami | --format <format> | Formato de salida: text o json (predeterminado: text) |
about | --format <format> | Formato de salida: text o json (predeterminado: text) |
Argumentos
Al iniciar el modo de chat (comportamiento predeterminado), puedes proporcionar una instrucción inicial:
Argumentos:
prompt— Instrucción inicial para el agente
Obtener ayuda
Todos los comandos admiten la opción global -h, --help para mostrar la ayuda de cada comando.