{"repo":"chekusu/mails","free":true,"listed":false,"github":"https://github.com/chekusu/mails","clone":"git clone https://github.com/chekusu/mails.git","description":"email for agents. Built for AI agents that need to send, receive, and understand emails programmatically","language":"TypeScript","stars":364,"topics":["agent","cli","mail"],"license":null,"category":"cli-tools","readme_excerpt":"mails 面向 AI Agent 的邮件基础设施。通过编程方式收发邮件。 English 日本語 中文 工作原理 特性 - 发送邮件 — 多 provider 链：Cloudflare Email Service（原生 env.EMAIL.send() binding，公开 beta）与 Resend 互为兜底，默认顺序 cloudflare,resend ，通过 EMAIL PROVIDERS 覆盖 - 接收邮件 — 通过 Cloudflare Email Routing Worker - 搜索收件箱 — 按关键词搜索主题、正文、发件人、验证码 - 验证码自动提取 — 自动从邮件中提取验证码（支持中/英/日/韩） - 附件 — CLI --attach 或 SDK 发送，Worker 自动解析 MIME 附件 - 存储 Provider — 本地 SQLite、db9.ai 云端 PostgreSQL、或远程 Worker API - Provider 可见性 — /api/send 响应与 /api/inbox 的 outbound 行携带 provider 字段（ cloudflare / resend ），知道是谁真正投递的 - 零运行时依赖 — provider 全部走 Workers binding 或原生 fetch() ，不引 SDK - 托管服务 — 通过 mails claim 免费获取 @mails.dev 邮箱 - 自部署 — 部署自己的 Worker，并使用 mailbox 级 token 鉴权 安装 CLI 最多每 24 小时检查一次 npm；发现新版本时，会在 stderr 打印升级提醒。可用 MAILS NO UPDATE CHECK=1 关闭（设置 NO UPDATE NOTIFIER=1 或 CI=1 时也会跳过检查）。 快速开始 托管模式 (mails.dev) 无需 Resend key — 托管用户每月 100 封免费发件。无限发送请配置自己的 key： mails config set resend api key re YOUR KEY 自部署模式 CLI 参考 claim send inbox 高级查询能力（附件 / 发件人 / 时间 / 邮件头过滤，以及发件人统计）目前仅通过 mails.dev 托管 HTTP API 提供，尚未接入 mails CLI 或 SDK。详见 docs/advanced-query-api.md。 code 验证码输出到 stdout，方便管道使用： CODE=$(mails code --to agent@test.com) config sync 从 Worker（托管或自部署）拉取邮件到本地 SQLite。适用于离线访问或本地备份。 SDK 用法 Email Worker worker/ 目录包含用于接收邮件的 Cloudflare Email Routing Worker。 部署 然后在 Cloudflare Email Routing 中配置转发到该 Worker。 安全配置 所有 /api/ 端点都需要 Authorization: Bearer 。这个 token 必须和 ?to= 、被读取的邮件、或发送时的 from 邮箱一致。 /health 始终公开。若未配置 mailbox token，访问 /api/ 会返回 503 。 Worker API 端点 说明 ------ ------ GET /api/inbox?to= &limit=20 邮","default_branch":null,"files":null,"tree":[],"storefront":"/r/chekusu","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/chekusu/mails/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}