moemail/packages/cli/README.md

MoeMail CLI

Agent-first CLI for MoeMail temporary email service

Install

npm i -g @moemail/cli

Quick Start

1. Configure default domain

moemail config --domain moemail.app

2. Create a temporary email

moemail create --expiry 1h

3. Wait for messages

moemail wait --email-id <email_id> --timeout 120

Command Reference

Command	Description	Key Flags
config	Set default domain and options	--domain <domain>, --expiry <duration>
create	Create a temporary email address	--domain <domain>, --expiry <duration>, --json
list	List all temporary emails	--json
wait	Wait for incoming messages	--email-id <id>, --timeout <seconds>, --json
read	Read email message content	--email-id <id>, --message-id <id>, --json
send	Send email from temporary address	--email-id <id>, --to <address>, --subject <text>, --body <text>, --json
delete	Delete temporary email	--email-id <id>
skill install	Install AI agent skill	--platform <claude|codex|all>

Agent Workflow Example

The CLI is designed to support agent-first automation. Here's a typical workflow:

# Create temporary email and extract details
EMAIL=$(moemail create --domain moemail.app --expiry 1h --json)
EMAIL_ID=$(echo $EMAIL | jq -r '.id')
ADDRESS=$(echo $EMAIL | jq -r '.address')

# Use ADDRESS for signup or service registration...

# Wait for verification email
MSG=$(moemail wait --email-id $EMAIL_ID --timeout 120 --json)
MSG_ID=$(echo $MSG | jq -r '.messageId')

# Read message content
CONTENT=$(moemail read --email-id $EMAIL_ID --message-id $MSG_ID --json)

# Extract verification code from CONTENT...

# Cleanup
moemail delete --email-id $EMAIL_ID

AI Agent Skill

The CLI ships with a built-in skill file that teaches AI agents how to use MoeMail. Install it to your agent platform:

# Auto-detect installed platforms (Claude Code, Codex)
moemail skill install

# Install to a specific platform
moemail skill install --platform claude
moemail skill install --platform codex

# Install to all supported platforms (skip detection)
moemail skill install --platform all

After installation, AI agents will automatically know how to create temporary emails, wait for messages, and read content using the MoeMail CLI.

JSON Output

All commands support --json flag for structured output, making them ideal for agent automation:

• Success: Command output in JSON format to stdout
• Errors: Error messages written to stderr
• Exit Codes:
  • 0: Command succeeded
  • 1: Runtime error (invalid input, service error)
  • 2: Configuration error (missing domain, invalid credentials)

Project Links

• Main Project: https://github.com/beilunyang/moemail
• Issues & Feedback: https://github.com/beilunyang/moemail/issues

License

MIT