A CLI for AI agents, built for automation
A command-line tool designed for AI agents and headless browsers. Create disposable identities, wait for emails and extract verification codes in a single pipeline.
The dna CLI gives your AI agent a disposable email identity in a single command. Each identity comes with a unique address and an encrypted password, ready to be typed into any form by Playwright, Puppeteer or any other automation framework.
npm install -g @dissolve-email/cli
dna auth
dna create --json
Wait for the email, get the code
After the agent fills out a signup form, it calls dna verify to wait for the confirmation email and extract the verification code automatically. More than 13 built-in extraction patterns detect OTP codes, tokens and verification links with confidence scoring. No retry loops or sleep timers needed.
dna verify <id> --timeout 30 --quiet
Made for machines
Every command supports --json, --quiet and --no-color, exits with meaningful codes and authenticates from an environment variable, so it drops straight into CI pipelines and agent shell tools. See the CLI page for the full command list, or the docs for every flag.
For testing and automation only. Generated personas are fictional identities for automated testing, QA workflows and development. Do not use them for identity fraud, impersonation, scams or any illegal activity. We are not responsible for misuse of generated data. By using this feature you agree to our acceptable use policy.
Why it helps
Agent-first design
JSON output, exit codes, environment variable auth and non-interactive mode. Every choice is made for machines.
Smart code extraction
More than 13 built-in patterns detect OTPs, tokens and verification links with confidence scoring. Custom regex works too.
Long polling built in
Block until an email arrives or a code is found. No polling loops, no sleep timers, no wasted calls.
Encrypted credentials
Each identity's password is encrypted at rest. Only the authenticated owner can decrypt it.
Questions
How do I use the CLI with Playwright or Puppeteer?
Run 'dna create --json' to generate a disposable email and password. Parse the JSON to get the credentials, then have your automation framework fill in the signup form. After submitting, run 'dna verify <id> --timeout 30 --quiet' to wait for the confirmation email and print the verification code on stdout.
Does the CLI work in headless CI environments?
Yes. Set the DISSOLVE_API_KEY environment variable and every command runs non-interactively. The CLI ships prebuilt binaries for Linux x64 and arm64, so it works on GitHub Actions, GitLab CI and any Docker-based runner without extra dependencies.
How does verification code extraction work?
The CLI reads the email's text and HTML with more than 13 built-in patterns. It detects six-digit OTP codes, alphanumeric tokens, prefixed codes such as G-847293, spaced digits and verification links. Each match gets a confidence score, and you can supply your own regex with --pattern.
What plans support the CLI?
The CLI needs a Pro or Business API key. Pro supports up to 10 active agent identities with 30-second wait timeouts. Business supports up to 50 with 120-second timeouts.
Can I use environment variables instead of interactive login?
Yes. Set DISSOLVE_API_KEY to your API key, and optionally DISSOLVE_API_URL to point at a different endpoint. The CLI also accepts --api-key on any command and falls back to ~/.config/dna/config.json.
What are agent personas?
Personas generate fictional but structurally valid identity data (name, address, phone, date of birth) alongside each disposable email. Supported countries include US, UK, AU, CA, DE, FR, JP, BR, IN, ES, IT, NL, KR, MX, SE, PL and NZ, and you can choose the country and gender. Personas are for testing and automation only and need a Pro or Business plan. Pass --persona to dna create, and use --country and --gender to control the output.
Can I make --persona the default for every create?
Yes. Run 'dna config set defaults.persona true' and every later 'dna create' includes a persona. You can also set defaults.country and defaults.gender. The --no-persona flag overrides the default when you do not need one.
Related features
Agent API
Pro and upDisposable email and password pairs for AI agents and browser automation, with verification codes extracted for you.
Learn moreSDK
Pro and upA fully typed TypeScript SDK for creating inboxes, reading messages and automating email from code.
Learn moreInbox rules
Pro and upAutomate your disposable email workflow with rules that filter, route and act on incoming messages.
Learn moreAutomate signups in minutes
Install the CLI, create a disposable identity and extract your first verification code in under 60 seconds.