Référence des commandes · Cursor CLI
agent login
Authentifie la CLI avec le compte Cursor via le flux de connexion dans le navigateur.
agent login démarre le flux de connexion OAuth basé sur le navigateur et relie la CLI au compte Cursor ; les identifiants sont ensuite stockés localement en sécurité. Pour les environnements automatisés comme le CI/CD ou les serveurs sans navigateur, des alternatives existent : une clé API générée via le tableau de bord Cursor peut être définie comme variable d'environnement CURSOR_API_KEY ou transmise directement avec le flag global --api-key <key>, ce qui évite complètement le flux de connexion. Si aucun navigateur ne peut être ouvert automatiquement, NO_OPEN_BROWSER=1 agent login affiche à la place uniquement l'URL de connexion, à ouvrir manuellement. Depuis début juillet 2026, il est également possible, pendant la connexion (ou au premier démarrage), d'afficher avec la touche q un QR code pour cette même URL, afin de finaliser la connexion confortablement depuis un smartphone, par exemple lors d'une session SSH. Le statut de connexion peut être vérifié à tout moment avec agent status.
✅ QUAND L’UTILISER ?
Première configuration de la CLI sur un nouvel ordinateur
agent login
Connexion via SSH sur un serveur distant sans fenêtre de navigateur propre
appuyer sur q pendant agent login et scanner le QR code affiché depuis un smartphone
⛔ QUAND ÉVITER ?
La CLI tourne en mode headless en CI/CD sans session interactive
agent login suppose un flux interactif via navigateur ou QR code et bloque sans saisie utilisateur.
Mieux: définir CURSOR_API_KEY ou transmettre --api-key <key> pour sauter l'étape de connexion
Le navigateur ne peut pas s'ouvrir automatiquement sur la machine
agent login tente par défaut de lancer directement le navigateur par défaut.
Mieux: définir NO_OPEN_BROWSER=1 agent login et ouvrir manuellement l'URL affichée
SOURCES
- Cursor Docs — CLI Reference: Parameters ↗ cursor.com
- Cursor Docs — Authentication ↗ cursor.com
- Cursor Docs — ACP ↗ cursor.com