agent status | agent whoami
显示当前的身份验证状态,以及账户和端点(Endpoint)信息。
agent status(别名:agent whoami)是 CLI 参考文档中的一个顶层命令,用于显示当前的身份验证状态。根据身份验证参考文档,输出内容包括你是否已登录、你的账号信息,以及当前的 Endpoint 配置——例如在使用不同或自托管的 API Endpoint 时会用到。 通过参数 --format <format>,可以在 text(默认)和 json 之间选择,使输出便于机器读取,很适合用于脚本或 CI 检查。根据文档,status 和 whoami 完全等价;两者都调用同一个功能。该命令本身不会更改登录状态,只是读取当前状态。
✅ 什么时候用?
在脚本运行前以机器可读方式检查 CLI 是否已登录
在 CI 脚本中加入 agent status --format json,在正式运行前检查认证状态
快速查看当前激活的账号和 Endpoint
调用 agent whoami,以默认文本格式显示账号和 Endpoint 配置
⛔ 什么时候不该用?
想要切换账号,而不只是查看
agent status 不会更改任何内容,它只显示当前状态。
更好的选择: 先执行 agent logout,再执行 agent login
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com