agent-vercel 是用于排查 Vercel 部署的 CLI，输入输出均为 JSON，无交互。列表输出为 NDJSON（每行一个对象，分页时追加 {"@pagination":…}）；单资源默认也输出 NDJSON，可用 --format json 获取完整对象。错误以 JSON 写到 stderr，含 fixable_by: agent|human|retry 与 hint。
用途与主要能力（读取类可自由使用）：deployment list 可跨项目按 state/target/since 筛选（这是 vercel CLI 难以做到的），deployment current 查看生产实际运行版本及滚动发布，deployment get/checks/routes/logs/runtime-logs 分别查看单次部署、CI 检查、编译后的重定向规则、构建日志与运行时日志；project crons/custom-environments/protection/routes 查看定时任务、自定义环境、401 原因与路由规则；env diff 与 env shared list 查看生产与预览环境变量差异及团队共享变量；domain inspect/cert list/projects/transfer 检查 DNS 与 SSL、即将过期证书、域名归属项目与转移状态；alias list、firewall config/attack-status、billing charges/consumption、webhook list、drains list、edge-config items、scope member list 分别查看别名、WAF、账单、Webhook、日志外发、特性开关与团队成员。get <id>... 支持多 id 按输入顺序返回，无法解析的 id 以 @unresolved 形式留在 stdout，退出码仍为 0；仅命令级失败（鉴权、网络）才写 stderr 并退出 1。
凭据与团队需分开选择：--auth 选择已存凭据，优先序为 --auth → $VERCEL_TOKEN → 存储默认；--scope 选择团队，优先序为 --scope → $VERCEL_SCOPE → $VERCEL_TEAM_ID → 存储默认 → 个人账号。token 存于系统钥匙串，不会打印或经 CLI 读出。首次使用可用 agent-vercel auth add --form（推荐，避免 token 进入对话或 shell 历史）、agent-vercel auth add personal、agent-vercel auth test、agent-vercel scope list/set-default 完成配置。
安全限制：promote、rollback、cancel、redeploy、修改环境变量、增删或验证域名、改别名、清理缓存等写操作必须用户明确要求，并需加 --yes；不加 --yes 时只会返回将要执行的操作描述。
适用场景为生产故障排查、部署与构建日志分析、域名与证书检查、费用与访问诊断等。资料未提供价格、平台支持范围以外的信息。需要更多命令、分页、输出格式与凭据诊断时，可查阅 references/commands.md 与 references/output.md，或用 agent-vercel usage 查看内置说明。