Cursor

Esta guía cubre la autenticación, configuración y uso de Cursor en un entorno de sandbox.

Documentación oficial: Cursor CLI

Inicio rápido

Crea un sandbox y ejecuta Cursor para un directorio de proyecto:

$ sbx run cursor ~/mi-proyecto

El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual:

$ cd ~/mi-proyecto
$ sbx run cursor

Autenticación

Cursor admite dos métodos de autenticación: una clave de API o OAuth.

Clave de API: Almacena tu clave de API de Cursor utilizando secretos guardados:

$ sbx secret set -g cursor

Alternativamente, exporta la variable de entorno CURSOR_API_KEY en tu shell antes de ejecutar el sandbox. Consulta Credenciales para obtener más detalles sobre ambos métodos.

OAuth: Si no se configura ninguna clave de API, Cursor te pedirá que inicies sesión de forma interactiva en la primera ejecución. El proxy intercepta el intercambio de tokens con api2.cursor.sh/auth/poll, por lo que las credenciales son gestionadas por el host y no se almacenan dentro del sandbox.

Configuración

Los sandboxes no heredan la configuración a nivel de usuario de tu host, como ~/.cursor. Solo la configuración a nivel de proyecto en el directorio de trabajo está disponible dentro del sandbox. Consulta ¿Por qué el sandbox no utiliza la configuración de mi agente a nivel de usuario? para conocer las soluciones alternativas.

Cursor lee AGENTS.md del espacio de trabajo para obtener instrucciones específicas del agente.

El sandbox ejecuta Cursor en modo YOLO por defecto, el cual ejecuta comandos sin avisos de aprobación. Pasa opciones adicionales de la CLI de cursor-agent después de --:

$ sbx run cursor --name <nombre-sandbox> -- <opciones-de-cursor>

Imagen base

Plantilla: docker/sandbox-templates:cursor-agent-docker

Preconfigurado para ejecutarse en modo YOLO con HTTP/1.1 y eventos enviados por el servidor (server-sent events) para el tráfico del agente, de modo que las solicitudes fluyan a través del proxy del host. El estado de autenticación persiste a lo largo de los reinicios del sandbox.

Consulta Personalización para preinstalar herramientas o personalizar este entorno.