1 Install

Install the CLI globally via npm.

npm install -g mails-agent

2 Claim a mailbox

Pick a name for your agent. This opens a browser window to confirm ownership.

mails claim myagent

Your agent gets [email protected].

3 Verify setup

Run the doctor command to confirm everything is configured correctly.

mails doctor

Shows config, API connectivity, mailbox, and send capability.

4 Send an email

Send a test email to your new mailbox.

mails send --to [email protected] --subject "Test" --body "Hello from my agent"

5 Check inbox

List all emails in the mailbox. Output is a colored table with emoji labels.

mails inbox

6 Extract verification code

Wait for a verification code to arrive and print it. Supports 4-8 digit codes in English, Chinese, Japanese, and Korean.

mails code --to [email protected] --timeout 30

7 Run the interactive demo

Sends a test email to yourself, waits for it to arrive, and displays it.

mails demo

Next steps