用途：以命令行的方式操作 agent-email，供智能体工作流创建临时收件箱、读取邮件和管理本地邮箱配置，便于在代理流程中安全、可预期地访问邮箱。
主要能力：创建邮箱账号（agent-email create）；读取最新邮件（agent-email read <email|default>），支持等待/轮询 --wait 30 --interval 2 和完整负载 --full；查看单封邮件详情（agent-email show <email|default> <messageId>）；管理邮箱配置（agent-email accounts list / use <email|default> / accounts remove <email>）；删除已处理邮件（agent-email delete <email|default> <messageId>）。命令输出建议保持机器可读，优先 JSON，并在摘要中返回 email、messageId、subject、createdAt、from.address 等关键字段。
使用方式：先确认是否安装：command -v agent-email 与 agent-email --help；缺失时安装：npm install -g @zaddy6/agentemail 或 bun install -g @zaddy6/agentemail。创建账号后从 JSON 输出记录 data.email、data.accountId、data.activeEmail。用户未指定邮箱时优先使用 default 别名。
限制与注意：不要记录、重复或打印邮箱密码、令牌等敏感值，也避免在命令行输入密钥。命令失败时直接呈现 JSON 错误码与提示字段；认证失败（AUTH_REQUIRED/401）重跑一次后需用户介入；限流（RATE_LIMITED/429）稍后重试。常见问题：命令未找到需将 ~/.bun/bin 或 npm 全局 bin 加入 PATH；NO_ACTIVE_ACCOUNT 需 create 或 use；ACCOUNT_NOT_FOUND 需 accounts list 后选择有效地址。其他细节暂未提供。