Agent skill

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.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/autohandai/community-skills/tree/main/agent-email-cli

SKILL.md

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
  1. 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.

  1. 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
  1. 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.

  1. 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.

  1. 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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

autohandai/community-skills

mapping-mitre-attack-techniques

Maps observed adversary behaviors, security alerts, and detection rules to MITRE ATT&CK techniques and sub-techniques to quantify detection coverage and guide control prioritization. Use when building an ATT&CK-based coverage heatmap, tagging SIEM alerts with technique IDs, aligning security controls to adversary playbooks, or reporting threat exposure to executives. Activates for requests involving ATT&CK Navigator, Sigma rules, MITRE D3FEND, or coverage gap analysis.

0 0
Explore
autohandai/community-skills

hunting-for-spearphishing-indicators

Hunt for spearphishing campaign indicators across email logs, endpoint telemetry, and network data to detect targeted email attacks.

0 0
Explore
autohandai/community-skills

analyzing-malicious-url-with-urlscan

URLScan.io is a free service for scanning and analyzing suspicious URLs. It captures screenshots, DOM content, HTTP transactions, JavaScript behavior, and network connections of web pages in an isolat

0 0
Explore
autohandai/community-skills

implementing-zero-standing-privilege-with-cyberark

Deploy CyberArk Secure Cloud Access to eliminate standing privileges in hybrid and multi-cloud environments using just-in-time access with time, entitlement, and approval controls.

0 0
Explore
autohandai/community-skills

implementing-pam-for-database-access

Deploy privileged access management for database systems including Oracle, SQL Server, PostgreSQL, and MySQL. Covers session proxy configuration, credential vaulting, query auditing, dynamic credentia

0 0
Explore
autohandai/community-skills

detecting-t1003-credential-dumping-with-edr

Detect OS credential dumping techniques targeting LSASS memory, SAM database, NTDS.dit, and cached credentials using EDR telemetry, Sysmon process access monitoring, and Windows security event correlation.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results