安装与登录
mailly-cli 把邮箱、发信、模板、Campaign 和 Agent 草稿带到终端,也方便 Agent 调用。
mailly-cli 封装了 Mailly HTTP API。每个命令都支持 --json,人和脚本、Agent 都能直接使用。
安装
需要 Node.js 18+。
npm install -g mailly-cli
mailly --help登录
# 打开浏览器授权(device code flow)
mailly login
# 远程或无图形环境:只打印授权链接
mailly login --no-browser
# CI:直接粘贴 API Key
mailly login <api-key>
mailly whoami
mailly balance凭据优先级
--api-key <key>- 环境变量
MAILLY_API_KEY ~/.mailly/config.json,由mailly login写入,权限0600
--base-url / MAILLY_BASE_URL 默认为 https://api.mailly.site。
不要把密码、验证码、token 或 API Key 发到 Agent 聊天里,也不要提交到代码仓库。
常用命令
# 列出邮箱并读取来信
mailly inbox addresses list
mailly inbox threads list --json
mailly inbox threads show <thread-id> --json
# 发送邮件
mailly send \
--to friend@example.com \
--subject "Hello from Mailly" \
--from-email your-inbox@mailly.site \
--html "<p>It works!</p>" \
--text "It works!"JSON 输出
成功时退出码为 0;失败时退出码为 1,并输出 {"success":false,"error":"..."}。
mailly balance --jsonAgent Skill
CLI Skill 教 Agent 怎么用 CLI:JSON 输出、等待验证码、回复草稿,以及完整的命令参考。开通邮箱用不到它,见让 Agent 帮你开通邮箱。
mkdir -p ~/.claude/skills/mailly
curl -fsSL https://raw.githubusercontent.com/superagents-lab/mailly-cli/main/skills/mailly/SKILL.md \
-o ~/.claude/skills/mailly/SKILL.md