agent login
Authentifiziert die CLI mit dem Cursor-Account über den Browser-Login-Flow.
agent login startet den browserbasierten OAuth-Login-Flow und verknüpft die CLI mit dem Cursor-Account; die Zugangsdaten werden anschließend lokal sicher gespeichert. Für automatisierte Umgebungen wie CI/CD oder Server ohne Browser gibt es Alternativen: Ein über das Cursor-Dashboard erzeugter API-Key lässt sich als Umgebungsvariable CURSOR_API_KEY setzen oder direkt mit dem globalen Flag --api-key <key> übergeben, wodurch der Login-Flow komplett entfällt. Kann kein Browser automatisch geöffnet werden, gibt NO_OPEN_BROWSER=1 agent login stattdessen nur die Login-URL aus, die man manuell öffnet. Seit Anfang Juli 2026 lässt sich während des Logins (oder beim ersten Start) zusätzlich mit der Taste q ein QR-Code für dieselbe URL anzeigen, um die Anmeldung z. B. über eine SSH-Sitzung bequem vom Smartphone abzuschließen. Der Anmeldestatus lässt sich jederzeit mit agent status prüfen.
✅ WANN EINSETZEN?
Erstes Setup der CLI auf einem neuen Rechner
agent login
Anmeldung über SSH auf einem Remote-Server ohne eigenes Browserfenster
q während agent login drücken und den angezeigten QR-Code vom Smartphone scannen
⛔ WANN EHER NICHT?
CLI läuft headless in CI/CD ohne interaktive Sitzung
agent login setzt einen interaktiven Browser- bzw. QR-Code-Flow voraus und blockiert ohne Nutzereingabe.
Besser: CURSOR_API_KEY setzen oder --api-key <key> übergeben, um den Login-Schritt zu überspringen
Browser lässt sich auf dem Rechner nicht automatisch öffnen
agent login versucht standardmäßig, den Standardbrowser direkt zu starten.
Besser: NO_OPEN_BROWSER=1 agent login setzen und die ausgegebene URL manuell öffnen
QUELLEN
- Cursor Docs — CLI Reference: Parameters ↗ cursor.com
- Cursor Docs — Authentication ↗ cursor.com
- Cursor Docs — ACP ↗ cursor.com