Referencia de comandos · Cursor CLI
agent login
Autentica la CLI con la cuenta de Cursor mediante el flujo de login del navegador.
agent login inicia el flujo de inicio de sesión OAuth basado en navegador y vincula la CLI con la cuenta de Cursor; las credenciales se guardan después de forma segura en local. Para entornos automatizados como CI/CD o servidores sin navegador existen alternativas: una API key generada desde el panel de Cursor se puede definir como variable de entorno CURSOR_API_KEY o pasar directamente con el flag global --api-key <key>, con lo que el flujo de inicio de sesión se omite por completo. Si no se puede abrir un navegador automáticamente, NO_OPEN_BROWSER=1 agent login solo muestra la URL de inicio de sesión, que se abre manualmente. Desde principios de julio de 2026, durante el inicio de sesión (o en el primer arranque) también se puede mostrar con la tecla q un código QR para esa misma URL, para completar cómodamente el inicio de sesión desde el móvil, por ejemplo en una sesión SSH. El estado de inicio de sesión se puede comprobar en cualquier momento con agent status.
✅ ¿CUÁNDO USARLO?
Primera configuración de la CLI en un equipo nuevo
agent login
Inicio de sesión por SSH en un servidor remoto sin ventana de navegador propia
pulsar q durante agent login y escanear el código QR mostrado desde el móvil
⛔ ¿CUÁNDO MEJOR NO?
La CLI se ejecuta headless en CI/CD sin sesión interactiva
agent login requiere un flujo interactivo de navegador o código QR, y se bloquea sin intervención del usuario.
Mejor: definir CURSOR_API_KEY o pasar --api-key <key> para omitir el paso de inicio de sesión
El navegador no se puede abrir automáticamente en el equipo
agent login intenta por defecto iniciar directamente el navegador predeterminado.
Mejor: definir NO_OPEN_BROWSER=1 agent login y abrir manualmente la URL mostrada
FUENTES
- Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com
- Documentación de Cursor — Authentication ↗ cursor.com
- Documentación de Cursor — ACP ↗ cursor.com