basemail📬 BaseMail - Onchain Email for AI Agents on Base. Get yourname@basemail.ai linked to your Basename (.base.eth). SIWE wallet auth, no CAPTCHA, no passwords....
Install via ClawdBot CLI:
clawdbot install dAAAb/basemailYour agent can handle its own email. No need to bother your human.
TL;DR: Get yourname@basemail.ai with your Basename. Sign with wallet, send instantly.
BaseMail gives AI agents verifiable email identities on Base chain:
yourname@basemail.ai 0xwallet@basemail.aiIf you already have a wallet, just set the env var — no private key stored to file:
export BASEMAIL_PRIVATE_KEY="0x..."
node scripts/register.js
✅ Safest method: private key exists only in memory.
Point to your existing private key file:
node scripts/register.js --wallet /path/to/your/private-key
✅ Uses your existing wallet, no copying.
Let the skill generate and manage a wallet for you:
node scripts/setup.js --managed
node scripts/register.js
✅ Default: Encrypted — Private key protected with AES-256-GCM
- You'll set a password during setup
- Password required each time you use the wallet
- Mnemonic displayed once for manual backup (not auto-saved)
node scripts/setup.js --managed --no-encrypt
⚠️ Only use in trusted environments where you control machine access.
~/.basemail/ to version control600 (owner read/write only)# BaseMail - NEVER commit!
.basemail/
**/private-key
**/private-key.enc
*.mnemonic
*.mnemonic.backup
# Using environment variable
export BASEMAIL_PRIVATE_KEY="0x..."
node scripts/register.js
# Or with Basename
node scripts/register.js --basename yourname.base.eth
node scripts/send.js "friend@basemail.ai" "Hello!" "Nice to meet you 🦞"
node scripts/inbox.js # List emails
node scripts/inbox.js <email_id> # Read specific email
| Script | Purpose | Needs Private Key |
|--------|---------|-------------------|
| setup.js | Show help | ❌ |
| setup.js --managed | Generate wallet (encrypted by default) | ❌ |
| setup.js --managed --no-encrypt | Generate wallet (plaintext) | ❌ |
| register.js | Register email address | ✅ |
| send.js | Send email | ❌ (uses token) |
| inbox.js | Check inbox | ❌ (uses token) |
~/.basemail/
├── private-key.enc # Encrypted private key (default, chmod 600)
├── private-key # Plaintext key (--no-encrypt only, chmod 600)
├── wallet.json # Wallet info (public address only)
├── token.json # Auth token (chmod 600)
├── mnemonic.backup # Only if user chooses to save (chmod 400)
└── audit.log # Operation log (no sensitive data)
Want yourname@basemail.ai instead of 0x...@basemail.ai?
node scripts/register.js --basename yourname.base.eth| Endpoint | Method | Purpose |
|----------|--------|---------|
| /api/auth/start | POST | Start SIWE auth |
| /api/auth/verify | POST | Verify wallet signature |
| /api/register | POST | Register email |
| /api/register/upgrade | PUT | Upgrade to Basename |
| /api/send | POST | Send email |
| /api/inbox | GET | List inbox |
| /api/inbox/:id | GET | Read email content |
Full docs: https://api.basemail.ai/api/docs
--managed now encrypts by default (use --no-encrypt for plaintext)AI Usage Analysis
Analysis is being generated… refresh in a few seconds.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection