Use the local `mailerboi` CLI to inspect and manage IMAP email accounts from the command line. Trigger this skill when you need to work with email through `~/.local/bin/mailerboi`, including listing configured accounts, diagnosing IMAP connectivity, checking unread counts, listing folders, listing or reading messages, searching by sender/subject/date, moving or deleting messages, setting flags, downloading attachments, or creating drafts. This tool can create drafts but it must NEVER be used to send email because sending is not supported.
Use ~/.local/bin/mailerboi as the primary interface for email work.
doctor first if connectivity is uncertain.list, search, or check to find candidate messages.read to inspect content before destructive actions.--output toon for structured output because TOON is compact and more token-efficient than JSON.--output json only when JSON is specifically required by another tool, parser, or downstream step.move, delete, flag, draft, download) after confirming account, mailbox, and UID.mailerboi.mailerboimailerboi can inspect mailboxes, modify mailbox state, download attachments, and create drafts only.mailerboi and offer saving the message to Drafts instead.If the user asks to send an email, do not improvise and do not pretend the tool can do it.
Respond along these lines:
mailerboi cannot send email. It can only inspect mail, modify mailbox state, download attachments, and save drafts.# Inspect configured accounts
~/.local/bin/mailerboi -o toon list-accounts
# Verify connectivity before doing anything else
~/.local/bin/mailerboi -o toon --account personal doctor
# Check unread counts
~/.local/bin/mailerboi -o toon --account personal check
# List recent mail in INBOX as compact structured data
~/.local/bin/mailerboi -o toon --account personal --output toon list --mailbox INBOX --limit 20
# Read a specific message
~/.local/bin/mailerboi -o toon --account personal read 1234 --mailbox INBOX
Need to confirm setup or fix connection issues?
doctor.Need to inspect mail?
check, folders, list, search, and read.Need to change mailbox state?
flag, move, delete, or draft.See REFERENCE.md for detailed configuration, command reference, and workflow recipes.