1
登录
会打开您的浏览器。
bash
npx cybertemp login2
创建收件箱
输出邮箱地址。
bash
ADDR=$(npx cybertemp new)3
等待 OTP
需 Core 及以上套餐。
bash
OTP=$(npx cybertemp wait-otp "$ADDR")身份验证
类似 GitHub 的设备授权方式，无需复制粘贴密钥。
npx cybertemp login 会打开您的默认浏览器。您批准该设备后，CLI 将获得一个受限令牌，写入至 ~/.config/cybertemp/config.json （权限 600）。
令牌按设备发放，可在以下位置撤销： 设置 → CLI 会话. 运行 npx cybertemp logout 即可在本地和服务器端同时撤销。
在没有浏览器的机器上，运行 npx cybertemp login --no-browser 并在任意设备上打开输出的链接。
在 CI 中，跳过登录并将 CYBERTEMP_API_KEY 设置为您在设置中获取的 API 密钥。它的优先级高于已保存的登录。
不支持匿名使用。 CLI 必须登录后使用 — 没有演示模式。
命令
完整的 CLI 命令列表。
| npx cybertemp login [--no-browser] | 在浏览器中批准此设备。令牌将保存至 ~/.config/cybertemp/config.json。 |
| npx cybertemp logout | 撤销当前设备的令牌并删除本地配置。 |
| npx cybertemp whoami | 显示已登录的账户、套餐和当前用量。 |
| npx cybertemp new [--domain <domain>] [--username <name>] | 创建一个新收件箱，并将邮箱地址输出到 stdout。 |
| npx cybertemp list | 列出您的活动收件箱。 |
| npx cybertemp wait <address> [--timeout <s>] | 阻塞等待，直到收件箱收到邮件，然后输出该邮件。 |
| npx cybertemp wait-otp <address> [--timeout <s>] | 等待 OTP（需 Core+）。仅将验证码输出到 stdout — 在脚本中很实用。 |
| npx cybertemp messages <address> [--limit <n>] | 列出收件箱中的邮件。 |
| npx cybertemp delete <address> | 删除一个收件箱。 |
| npx cybertemp domains | 列出可用于创建收件箱的域名。 |
在免费套餐上
CLI 同样适用于免费版。它以您的账户身份运行，因此适用您套餐的 API 限制。
每条调用 API 的命令都会计入您套餐的每秒速率限制，它打开的每个收件箱都会计入并发收件箱上限。付费套餐会同时提高这两项限制 — 详见 价格页.
当您达到套餐上限时，CLI 会输出：
✗ Inbox limit reached (5/5 on the Free plan).
Delete one with: cybertemp delete <address>
Or upgrade at https://cybertemp.xyz/pricing?ref=cli_quota在脚本中使用
结果输出到 stdout，进度、提示和错误输出到 stderr。
所有命令都支持 --json 选项，用于输出机器可读的 JSON。
bash
ADDR=$(npx cybertemp new)
# …submit a sign-up form with "$ADDR"…
OTP=$(npx cybertemp wait-otp "$ADDR" --timeout 120)
case $? in
0) echo "code: $OTP" ;;
3) echo "no code in time" ;;
*) exit 1 ;;
esac退出码
| 0 | 成功 |
| 1 | 错误：API、网络、登录或套餐限制 |
| 2 | 用法错误：未知的命令或选项，或缺少参数 |
| 3 | 超时（wait、wait-otp） |
需要更高的限制？
付费套餐会提高每秒速率限制以及可同时保留的收件箱数量。