Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mailgenius-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

mailgenius-cli — `genius`

The genius CLI for MailGenius. Log in, manage keys and webhook subscriptions, send transactional emails, emit events, and tail the audit log — straight from your terminal.

Install

npm install -g mailgenius-cli
# or run ad-hoc
npx -y mailgenius-cli help

Authenticate

genius login
# Open https://app.mailgenius.pro/settings/api-keys, create a key, paste it.

The token is written to ~/.mailgenius/credentials.json with 0600 permissions and is shared with the mailgenius-mcp stdio bridge.

MAILGENIUS_API_KEY env var always wins, so CI runs don't need to write to disk.

Common workflows

genius whoami
genius keys list
genius templates list
genius templates send welcome --to=aki@example.com --vars='{"firstName":"Aki"}'
genius events emit subscription.cancelled --email=aki@example.com --traits='{"reason":"price"}'
genius webhooks create --url=https://example.com/mg --events=send.delivered,send.bounced
genius logs tail

genius logs tail polls /v1/audit every 5 s (configurable with --interval) and prints new entries as they appear — handy when verifying that an integration is wiring up to the right hooks.

Connecting to a non-default API host

genius login --api-url=https://api.staging.mailgenius.pro
# or per-call
genius whoami --api-url=https://api.staging.mailgenius.pro

License

MIT

mailgenius-cli