用途：auth-agent 是用于 Agent Auth 提供方身份认证与能力调用的命令行工具。资料说明应优先使用该 CLI 进行智能体认证操作，而不要直接发原始 HTTP 请求或编写自定义代码。未全局安装时可通过 npx @auth/agent-cli 运行。
主要能力与用法：先发现或搜索提供方，例如 auth-agent discover https://api.example.com、auth-agent search "deploy web apps"、auth-agent providers。discover 会获取 /.well-known/agent-configuration 并缓存提供方。随后用 auth-agent capabilities --provider <url>（可加 --query 过滤）列出能力，用 auth-agent describe <capability> --provider <url> 查看输入结构，执行前应先 describe。连接使用 auth-agent connect --provider <url> --capabilities ... --name ...，可带 --constraints 限制参数、--mode autonomous、--preferred-method ciba 与 --login-hint；需保存返回的 agent_id。之后用 auth-agent status <agent-id> 确认是否需审批及已授权能力，用 auth-agent execute <agent-id> <capability> --args '{...}' 执行。还可 request 申请新能力、disconnect 断开、reactivate 重新激活、connection/connections 查看连接、rotate-agent-key 与 rotate-host-key 轮换密钥、enroll-host 注册主机、sign 手动签发 JWT。
全局标志：--storage-dir/AGENT_AUTH_STORAGE_DIR、--directory-url/AGENT_AUTH_DIRECTORY_URL、--host-name/AGENT_AUTH_HOST_NAME、--no-browser/AGENT_AUTH_NO_BROWSER、--url/AGENT_AUTH_URLS。默认存储目录为 ~/.agent-auth，包含 host.json、agents/<agent-id>.json 和 providers/<encoded-issuer>.json。生产环境应设置 AGENT_AUTH_ENCRYPTION_KEY 加密私钥。
限制与注意事项：连接前先 discover，执行前先 describe，连接后检查 status，并妥善保存 agent_id；建议用 constraints 限制权限。资料未提供具体提供方列表、审批时效、错误码或收费信息。