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.
Security Assessment
About agent-email-cli
The `agent-email-cli` skill provides terminal-based access to disposable email inboxes for automation workflows involving large language models (LLMs) or other agents. It allows users to safely create, read, and manage email accounts without exposing sensitive credentials, ensuring secure handling of email data in automated processes. This skill addresses the need for ephemeral email interactions in scenarios where conventional inbox access is impractical or introduces security risks, enabling agents to interact with email systems programmatically and reliably.
Key features of `agent-email-cli` include creating new mailbox accounts, polling for new messages, retrieving full message details, and managing local mailbox profiles. Users can perform actions such as reading the latest messages, accessing detailed message content via `show`, and deleting processed emails. The skill emphasizes JSON-native outputs for machine readability and ensures sensitive information such as passwords or tokens is never exposed. Operational guidance includes handling errors, authentication failures, and rate limits to maintain reliable execution in automated workflows.
This skill is particularly useful for developers, automation engineers, and AI practitioners who require programmatic email access in their LLM or agent-based workflows. Typical use cases include automated verification code retrieval, inbox monitoring, and email-based notification handling. By providing a CLI interface optimized for automation, `agent-email-cli` enables secure, efficient, and predictable email interactions in development, testing, and production environments where human interaction with email accounts is minimal or undesirable.
FAQ
How do I create a new mailbox account using agent-email-cli?
Run `agent-email create` in your terminal. The command will return JSON with fields such as `email`, `accountId`, and `activeEmail`. Do not record or expose passwords or tokens.
Which platforms or environments support agent-email-cli?
The CLI can be installed using npm or bun and requires the global binary path to be on your system PATH. It is compatible with environments where these package managers are supported.
Can I retrieve full email content programmatically?
Yes, use `agent-email read <email|default> --full` or `agent-email show <email|default> <messageId>` to access complete message details including the body and source content.
What should I do if I encounter an authentication error?
If you receive an `AUTH_REQUIRED` or 401 error, rerun the command once. If the issue persists, user intervention may be needed to re-establish credentials using `agent-email create` or `agent-email use <email>`.
Are there any limitations regarding sensitive data?
Yes, the CLI never exposes or logs secrets such as passwords or tokens. Avoid commands that require entering secrets directly on the command line in automation logs.
Install agent-email-cli
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
zaddy6/agent-email-skill