| name | moemail |
| description | Use when working in this repository and an AI agent needs a temporary/disposable email address through the MoeMail CLI. |
MoeMail for This Repository
When to use
Use this skill when you are inside the moemail repository and need to create inboxes, wait for messages, read message content, or send test emails with the MoeMail CLI.
Install
Install the MoeMail CLI globally when it is not already available:
npm i -g @moemail/cli
Then confirm the binary is available:
moemail --help
Preferred CLI
Prefer the installed moemail CLI when it is available:
CLI="moemail"
If the global CLI is unavailable and you are working inside this repository, fall back to the repo-local build:
CLI="node packages/cli/dist/index.js"
If packages/cli/dist/index.js is missing or stale, rebuild it first:
(cd packages/cli && bun run build)
Setup
For local development against this repository:
$CLI config set api-url http://localhost:3000
$CLI config set api-key YOUR_API_KEY
For the hosted service, use https://moemail.app instead.
You can also use environment variables: MOEMAIL_API_URL, MOEMAIL_API_KEY.
Core workflow
RESULT=$($CLI --json create --expiry 1h)
ID=$(echo "$RESULT" | jq -r '.id')
EMAIL=$(echo "$RESULT" | jq -r '.address')
MSG=$($CLI --json wait --email-id "$ID" --timeout 120)
MSG_ID=$(echo "$MSG" | jq -r '.messageId')
$CLI --json read --email-id "$ID" --message-id "$MSG_ID"
Commands
| Command | Required options | Notes |
|---|
config set | <key> <value> | keys: api-url, api-key |
create | - | --name, --domain, --expiry |
list | - | --email-id, --cursor |
wait | --email-id | --timeout, --interval |
read | --email-id, --message-id | `--format text |
send | --email-id, --to, --subject, --content | - |
delete | --email-id | - |
Important details
--json is a global flag and works before or after the subcommand.- Call
create once and parse both id and address from the same JSON result.
- Check both
content and html when reading HTML-heavy messages.
