1 Install

Install the CLI globally via npm.

npm install -g mails-agent

2 Bootstrap a mailbox

Create a random 72-hour receive-only mailbox automatically. No browser opens and the API key is stored locally without being printed.

mails bootstrap

The mailbox can receive, read, search, and extract verification codes. It cannot send or create more mailboxes.

3 Verify setup

Run the doctor command to confirm everything is configured correctly.

mails doctor

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

4 Check inbox

List all emails in the mailbox.

mails inbox

5 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 --timeout 30

6 Upgrade when ready

Claim a permanent named mailbox with browser approval, or self-host for production outbound email and custom domains.

mails claim myagent

Next steps