Email Setup

You are setting up your own custom domain and email address. This is a one-time operation — once you have a domain and email, you do not need to run this again.

Prerequisites

Only proceed if the user explicitly asks you to create or set up your own (the assistant's) email address — e.g., "set up your email", "create your email address", "I want you to have your own email". Generic email requests like "send an email", "check my email", or "set up email" are about the user's personal email and should be handled by the Messaging skill, not this one. Do NOT proactively run this skill.

Step 1: Check if Domain & Email Already Exist

assistant domain status --json
assistant email status --json

If both commands show an active domain and email address, tell the user the existing address and stop.

If an email exists but no domain, the email was set up under the legacy shared domain — it still works. Ask the user if they want to keep it or migrate to a custom subdomain.

Step 2: Register Your Domain

Each assistant gets its own subdomain (e.g. mybot.vellum.me). This must be registered before creating an email address.

assistant domain register <subdomain>

For <subdomain>, use your assistant name (lowercased, alphanumeric, hyphens allowed). Check your identity from IDENTITY.md to determine your name. If you don't have a name yet, ask the user what subdomain they'd like.

If the domain is already registered, domain status will show it — skip to Step 3.

Step 3: Register Your Email

Once the domain is active, register your email username on that domain:

assistant email register <username>

This creates <username>@<subdomain>.vellum.me. Use the same name as your subdomain for simplicity (e.g. [email protected]), or ask the user if they prefer a different local part.

Step 4: Verify Status