himalaya-email

Himalaya Email CLI

Use himalaya (v1.2.0) for all email operations. The user's account should be configured in ~/Library/Application Support/himalaya/config.toml.

When to Use

• User asks about emails, inbox, or messages
• User wants to read, search, or list emails
• User wants to trace email origin or check headers
• User mentions a sender or subject and wants to find/read the email

Core Commands

# List recent emails (default: INBOX)
himalaya envelope list --page-size 20

# List emails in a specific folder
himalaya envelope list --folder "Sent" --page-size 20

# Read an email by ID (marks as seen)
himalaya message read <ID>

# Read without marking as seen (preview mode)
himalaya message read -p <ID>

# Read with no headers (body only)
himalaya message read --no-headers <ID>

# Read with specific headers visible
himalaya message read -H "From" -H "To" -H "Subject" -H "Date" <ID>

# Search/filter envelopes (if supported by backend)
himalaya envelope list --page-size 50

Tracing Email Origin / Headers

When the user wants to know where an email came from, read it with authentication headers:

himalaya message read -p \
  -H "From" \
  -H "Reply-To" \
  -H "Return-Path" \
  -H "Received" \
  -H "X-Originating-IP" \
  -H "Authentication-Results" \
  -H "Received-SPF" \
  -H "DKIM-Signature" \
  -H "ARC-Authentication-Results" \
  -H "Message-ID" \
  -H "X-Mailer" \
  <ID>

How to Interpret Headers

• SPF (Sender Policy Framework): spf=pass means the sending IP is authorized by the domain. Look for the IP in Received-SPF.
• DKIM (DomainKeys Identified Mail): dkim=pass means the email signature is valid and the content wasn't tampered with. Check header.d= for the signing domain.
• DMARC: dmarc=pass means the domain's SPF/DKIM alignment policy passed.
• ARC (Authenticated Received Chain): Shows authentication survived forwarding.
• Return-Path: The actual envelope sender (where bounces go).
• Received headers: Read bottom-to-top to trace the email's path through servers.
• Message-ID: Unique identifier; the domain after @ often reveals the originating mail system.
• X-Originating-IP: If present, the sender's actual IP address.