Referencia de comandos · Cursor CLI
agent status | agent whoami
Muestra el estado de autenticación actual, además de información de cuenta y endpoint.
agent status (alias: agent whoami) es un comando de nivel superior de la referencia de la CLI y muestra el estado de autenticación actual. Según la referencia de autenticación, la salida incluye si has iniciado sesión, la información de tu cuenta y la configuración actual del endpoint – relevante, por ejemplo, con endpoints de API alternativos o autoalojados. Con el flag --format <format> se puede elegir entre text (por defecto) y json, lo que hace la salida legible por máquina y resulta útil para scripts o comprobaciones de CI. Según la documentación, status y whoami son completamente equivalentes; ambos invocan la misma función. El comando no modifica nada respecto al inicio de sesión, solo consulta el estado actual.
✅ ¿CUÁNDO USARLO?
Comprobar de forma legible por máquina, antes de ejecutar un script, si la CLI tiene sesión iniciada
Incorporar agent status --format json en un script de CI para comprobar el estado de autenticación antes de la ejecución propiamente dicha
Consultar rápidamente qué cuenta y endpoint están activos
Invocar agent whoami para mostrar la cuenta y la configuración del endpoint en el formato de texto por defecto
⛔ ¿CUÁNDO MEJOR NO?
Se quiere cambiar de cuenta, no solo consultar
agent status no modifica nada, solo muestra el estado actual.
Mejor: Usar agent logout seguido de agent login
FUENTES
- Documentación de Cursor — CLI Reference: Parameters ↗ cursor.com