AgentMail CLI 是 AgentMail 的官方命令行工具，用于在 shell 中操作 AgentMail。安装方式为 npm install -g agentmail-cli，并通过环境变量提供 API Key：export AGENTMAIL_API_KEY="am_..."。
主要能力覆盖：收件箱的列出、获取、创建与删除；消息与会话（threads）的列出、获取、发送、回复、转发；草稿的创建、列出、获取与发送；Pods 用于将收件箱分组，支持创建 Pod、列出 Pod、在 Pod 下创建与列出收件箱、列出与获取 Pod 会话；Webhook 的创建与列出；域名的创建、验证与获取 zone file，创建域名时可选用 --feedback-enabled 将退信/投诉通知路由到收件箱。
用法上，嵌套资源使用嵌套子命令，例如 inboxes messages、inboxes threads、pods inboxes、pods threads（CLI 1.x；冒号形式 inboxes:messages 会被拒绝）。可运行 agentmail <resource> --help 查看某资源支持的操作。全局标志包括 --api-key（覆盖环境变量）、--base-url、--environment、--format、--format-error、--transform、--transform-error、--debug。--format 支持 auto（默认）、pretty、json、jsonl、yaml、raw、explore。
限制与注意事项：删除收件箱是破坏性操作，执行前需确认目标收件箱；回复需使用消息 ID，依赖正文内容前应先获取完整消息；使用未在此覆盖的管理类命令前，先运行 agentmail --help 及相关资源的 --help。其余未在资料中说明的功能、收费与平台信息暂未提供。