agent-email-cli
Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.
Best use case
agent-email-cli is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.
Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.
Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.
Practical example
Example input
Use the "agent-email-cli" skill to help with this workflow task. Context: Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.
Example output
A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.
When to use this skill
- Use this skill when you want a reusable workflow rather than writing the same prompt again and again.
When not to use this skill
- Do not use this when you only need a one-off answer and do not need a reusable workflow.
- Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/agent-email-cli/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How agent-email-cli Compares
| Feature / Agent | agent-email-cli | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
AI Agent for Cold Email Generation
Discover AI agent skills for cold email generation, outreach copy, lead personalization, CRM support, and sales-adjacent messaging workflows.
SKILL.md Source
# Agent Email CLI ## Overview Use this skill to operate the `agent-email` command safely and predictably for agent workflows that need inbox access. Prefer JSON-native command output and return key fields (`email`, `messageId`, `subject`, `createdAt`, `from.address`) in your summaries. ## Workflow 1. Verify CLI availability. ```bash command -v agent-email agent-email --help ``` If missing, install: ```bash npm install -g @zaddy6/agentemail # or bun install -g @zaddy6/agentemail ``` 2. Create a mailbox account. ```bash agent-email create ``` Record these fields from JSON output: - `data.email` - `data.accountId` - `data.activeEmail` Do not record, repeat, or print secret values such as mailbox passwords or tokens. 3. Read latest messages. ```bash agent-email read <email|default> ``` For inbox waiting/polling: ```bash agent-email read <email|default> --wait 30 --interval 2 ``` For full message payloads: ```bash agent-email read <email|default> --full ``` 4. Retrieve one message in detail. ```bash agent-email show <email|default> <messageId> ``` Use `show` when you need body/source details for verification links, codes, or full content extraction. 5. Manage mailbox profiles. ```bash agent-email accounts list agent-email use <email|default> agent-email accounts remove <email> ``` Avoid commands that require entering secrets on the command line in agent logs. 6. Delete processed/irrelevant message when requested. ```bash agent-email delete <email|default> <messageId> ``` ## Operational Guidance - Keep command output machine-readable; avoid forcing human output unless requested. - Prefer `default` alias when user does not specify an email. - Never echo, store, or summarize secret values (`password`, `token`) from command output. - If command fails, surface the JSON error `code` and `hint` fields directly. - For auth failures (`AUTH_REQUIRED`/401), rerun command once and request user intervention if credentials must be re-established. - For rate limits (`RATE_LIMITED`/429), retry after short delay. ## Troubleshooting - `command not found`: ensure `~/.bun/bin` or npm global bin path is on `PATH`. - `NO_ACTIVE_ACCOUNT`: run `agent-email create` or `agent-email use <email>`. - `ACCOUNT_NOT_FOUND`: run `agent-email accounts list` and pick a valid address. - `EOTP` during npm publish: use npm trusted publishing for CI or publish locally with OTP. ## References - For command cheat sheet and JSON field map, read [references/commands.md](references/commands.md).
Related Skills
email-systems
Email has the highest ROI of any marketing channel. $36 for every $1 spent. Yet most startups treat it as an afterthought - bulk blasts, no personalization, landing in spam folders. This skill covers transactional email that works, marketing automation that converts, deliverability that reaches inboxes, and the infrastructure decisions that scale. Use when: keywords, file_patterns, code_patterns.
react-email
Use when creating HTML email templates with React components - welcome emails, password resets, notifications, order confirmations, newsletters, or transactional emails.
email-composer
Draft professional emails for various contexts including business, technical, and customer communication. Use when the user needs help writing emails or composing professional messages.
email-marketing-bible
Comprehensive, data-backed email marketing knowledge base. 908 sources, 4,798 insights. Use when reviewing email setups, building automation flows, diagnosing deliverability, writing email copy, selecting platforms, or pulling benchmarks. Covers strategy, flows, deliverability, copywriting, segmentation, compliance, cold email, and 19 industry playbooks.
email-sequence
When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," or "lifecycle emails." For in-app onboarding, see onboarding-cro.
cold-email
Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions "cold outreach," "prospecting email," "outbound email," "email to leads," "reach out to prospects," "sales email," "follow-up email sequence," "nobody's replying to my emails," or "how do I write a cold email." Covers subject lines, opening lines, body copy, CTAs, personalization, and multi-touch follow-up sequences. For warm/lifecycle email sequences, see email-sequence. For sales collateral beyond emails, see sales-enablement.
email-assistant
User asks to read, check, or manage emails - User asks to reply to or send an email - User asks to draft an email response
email-agent
Processes incoming emails for Unite-Hub. Extracts sender data, identifies communication intents, links to CRM contacts, analyzes sentiment, and updates contact records with AI insights.
email-notify
Send SMTP email notifications after Codex completes a task. Use when one Codex or Claude run is finished, or when you need to notify on task completion with device name, project name, status, and summary via email.
email-handler
Create and send transactional emails using React Email. Covers templates, layout integration, and sending logic.
Email operations skill for sending, fetching, and reading emails via IMAP/SMTP. Uses curl with OpenSSL/LibreSSL for reliable TLS compatibility with Tencent Enterprise Mail and other providers. Credentials are securely stored in macOS Keychain.
azure-quotas
Check/manage Azure quotas and usage across providers. For deployment planning, capacity validation, region selection. WHEN: "check quotas", "service limits", "current usage", "request quota increase", "quota exceeded", "validate capacity", "regional availability", "provisioning limits", "vCPU limit", "how many vCPUs available in my subscription".