himalaya

Manage emails via IMAP and SMTP from the terminal using the himalaya CLI.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill himalaya-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: himalaya
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/himalaya
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill himalaya-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reading, searching, and sending email usually requires a GUI client or web interface, which breaks terminal-based and automated workflows. This Skill lets an agent perform full email operations—listing, reading, replying, forwarding, moving, and organizing messages—directly through the himalaya CLI. ## Core Features & Use Cases - Full Email Operations: List folders and envelopes, read messages, search by sender or subject, reply, forward, delete, and move or copy messages between folders. - Message Composition with MML: Compose plain-text or rich multipart emails with attachments and inline images using MIME Meta Language, sent interactively or piped from templates. - Multi-Account Support: Configure and switch between multiple IMAP/SMTP accounts (Gmail, iCloud, custom servers) with secure password handling via pass, keyring, or OAuth2. - Use Case: Ask the agent to check your inbox for unread messages from a client, summarize them, and send a reply with a PDF attachment—all without leaving the terminal. ## Quick Start Use himalaya to list the ten most recent emails in my inbox and show me any unread messages from this week.

Frequently Asked Questions about himalaya

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and reply to emails from the command line?

Use himalaya envelope list to view inbox messages, himalaya message read <id> to read one, and himalaya message reply <id> to reply in your editor. Add --all for reply-all, or pipe a template to himalaya template send for non-interactive sending.

How to send an email with attachments using himalaya?

Compose the message using MML syntax with <#part filename=/path/to/file.pdf> tags for each attachment, then send via himalaya message write or pipe the template to himalaya template send. MML compiles the parts into proper MIME format.

Does himalaya support Gmail and iCloud accounts?

Yes, himalaya supports Gmail via imap.gmail.com and iCloud via imap.mail.me.com over TLS. Both require app-specific passwords when two-factor authentication is enabled, configured in the TOML config file.

How do I store email passwords securely for himalaya?

Use backend.auth.cmd to call a password manager like pass, or backend.auth.keyring for the system keyring. Raw passwords via backend.auth.raw are supported but recommended only for testing.

Can himalaya manage multiple email accounts?

Yes, define multiple [accounts.name] sections in the config file and set one as default. Switch accounts per command with the --account flag, for example himalaya --account work envelope list.