Référence des commandes · Cursor CLI
agent status | agent whoami
Affiche le statut d'authentification actuel ainsi que les infos de compte et d'endpoint.
agent status (alias : agent whoami) est une commande de premier niveau de la référence de la CLI et affiche le statut d'authentification actuel. Selon la référence sur l'authentification, la sortie indique si tu es connecté, tes informations de compte ainsi que la configuration d'endpoint actuelle – pertinent par exemple en cas d'endpoints API différents ou auto-hébergés. Le flag --format <format> permet de choisir entre text (par défaut) et json, ce qui rend la sortie lisible par machine et convient bien aux scripts ou aux vérifications CI. Selon la documentation, status et whoami sont entièrement équivalents ; les deux appellent la même fonction. La commande ne modifie rien à la connexion elle-même, elle ne fait que lire l'état actuel.
✅ QUAND L’UTILISER ?
Vérifier de façon lisible par machine, avant l'exécution d'un script, si la CLI est connectée
Intégrer agent status --format json dans un script CI pour vérifier le statut d'authentification avant l'exécution proprement dite
Vérifier rapidement quel compte et quel endpoint sont actuellement actifs
Appeler agent whoami pour afficher le compte et la configuration d'endpoint au format texte par défaut
⛔ QUAND ÉVITER ?
On veut changer de compte, pas seulement vérifier
agent status ne modifie rien, il ne fait qu'afficher l'état actuel.
Mieux: Utiliser agent logout suivi de agent login
SOURCES
- Cursor Docs — CLI Reference: Parameters ↗ cursor.com