agent-email-cli

Agent Email CLI

概述

使用此技能可在需要访问收件箱的 Agent 工作流中，安全、可预测地运行 agent-email 命令。

优先使用原生 JSON 命令输出，并在摘要中返回关键字段（email、messageId、subject、createdAt、from.address）。

工作流

1. 验证 CLI 是否可用。

command -v agent-email
agent-email --help

如果未安装，请安装：

npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail

2. 创建邮箱账户。

agent-email create

从 JSON 输出中记录以下字段：

• data.email
• data.accountId
• data.activeEmail

不要记录、复述或打印邮箱密码、令牌等秘密值。

3. 阅读最新邮件。

agent-email read <email|default>

等待或轮询收件箱：

agent-email read <email|default> --wait 30 --interval 2

获取完整邮件负载：

agent-email read <email|default> --full

4. 查看一封邮件的详细信息。

agent-email show <email|default> <messageId>

需要验证链接、验证码或提取完整内容时，请使用 show 获取正文或源代码详情。

5. 管理邮箱配置文件。

agent-email accounts list
agent-email use <email|default>
agent-email accounts remove <email>

避免运行需要在命令行中输入秘密信息的命令，以免这些信息出现在 Agent 日志中。

6. 按要求删除已处理或无关的邮件。

agent-email delete <email|default> <messageId>

操作指南

• 保持命令输出为机器可读格式；除非用户要求，否则不要强制使用面向人工的输出。
• 用户未指定邮箱时，优先使用 default 别名。
• 绝不要回显、存储或总结命令输出中的秘密值（password、token）。
• 如果命令失败，直接显示 JSON 中的 code 和 hint 字段。
• 对于身份验证失败（AUTH_REQUIRED/401），重新运行命令一次；如果必须重新建立凭据，则请求用户介入。
• 对于速率限制（RATE_LIMITED/429），短暂延迟后重试。

故障排除

• command not found：确保 ~/.bun/bin 或 npm 全局 bin 路径已添加到 PATH。
• NO_ACTIVE_ACCOUNT：运行 agent-email create 或 agent-email use <email>。
• ACCOUNT_NOT_FOUND：运行 agent-email accounts list 并选择有效地址。
• npm 发布时出现 EOTP：CI 中使用 npm 可信发布，或使用 OTP 在本地发布。

参考资料

• 命令速查表和 JSON 字段映射请参阅 references/commands.md。