name: email-himalaya description: Manage emails using the himalaya CLI client. This skill should be used when the user wants to read, list, search, send, reply to, or manage emails across their configured accounts.

Email Management with Himalaya

This skill provides email management capabilities using the himalaya CLI email client.

Configured Accounts

Configure your accounts in ~/.config/himalaya/config.toml. Example:

Core Commands

Listing Emails

# List inbox (default account)
himalaya envelope list --page-size 10

# List from specific account
himalaya envelope list --account "Personal" --page-size 10

# List from specific folder
himalaya envelope list --folder "[Gmail]/Important" --page-size 10

# JSON output for parsing
himalaya envelope list --output json --page-size 10

Reading Emails

# Read email by ID
himalaya message read <id>

# Read in plain text
himalaya message read <id> --header "From,To,Subject,Date"

IMPORTANT: Keeping Emails Unread

When reading emails, himalaya marks them as read. To preserve the unread status for the user:

# After reading, mark back as unread
himalaya flag remove <id> Seen

Always mark emails back as unread after reading unless the user explicitly says they've read it or asks to mark it as read.

Sending Emails

# Send using heredoc
himalaya message send --account "Account Name" <<'EOF'
From: Display Name <email@example.com>
To: recipient@example.com
Subject: Subject Line

Email body here.

Signature
EOF

Replying to Emails

# Reply to an email
himalaya message reply <id> <<'EOF'
Reply body here.
EOF

Managing Flags

# Mark as read
himalaya flag add <id> Seen

# Mark as unread
himalaya flag remove <id> Seen

# Star/flag email
himalaya flag add <id> Flagged

# Remove star
himalaya flag remove <id> Flagged

Searching Emails

# Search by subject
himalaya envelope list --query "subject:keyword"

# Search by sender
himalaya envelope list --query "from:sender@example.com"

Folders

# List folders
himalaya folder list

# Common Gmail folders
# - INBOX
# - [Gmail]/Sent Mail
# - [Gmail]/Drafts
# - [Gmail]/Trash
# - [Gmail]/Important
# - [Gmail]/Starred

Workflow Guidelines

1. Listing emails: Use envelope list - this does NOT mark emails as read
2. Reading emails: After reading with message read, immediately run flag remove <id> Seen to keep unread unless user indicates otherwise
3. Multiple accounts: Always specify --account "Account Name" when working with non-default account
4. Sending emails: Draft the email content and show to user for approval before sending
5. Replying: Read the original email first to understand context, then draft reply for user approval

Common Tasks

Check unread emails across both accounts

himalaya envelope list --account "Work" --page-size 10
himalaya envelope list --account "Personal" --page-size 10

Read and keep unread

himalaya message read <id>
himalaya flag remove <id> Seen

Send from personal account

himalaya message send --account "Personal" <<'EOF'
From: Your Name <personal@gmail.com>
To: recipient@example.com
Subject: Subject

Body
EOF