himalaya

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

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill himalaya-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: himalaya
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/himalaya
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill himalaya-shalevamin

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 webmail; this Skill lets you perform full email management directly from the terminal using the himalaya CLI over IMAP/SMTP. ## Core Features & Use Cases - Email Operations: List, read, search, reply, forward, move, copy, and delete messages across folders and multiple accounts. - Rich Composition: Compose plain-text or multipart MIME emails with attachments and inline images using MML (MIME Meta Language). - Structured Output: Export envelopes and messages as JSON for scripting and automation pipelines. - Use Case: Ask the agent to search your inbox for unread messages from a client, reply to the latest one, and archive the thread — all without leaving the terminal. ## Quick Start Use the himalaya skill to list the 20 most recent emails in my inbox and summarize their subjects and senders.

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 do I configure himalaya for Gmail or iCloud?

Create ~/.config/himalaya/config.toml with an IMAP backend (imap.gmail.com:993 or imap.mail.me.com:993) and SMTP backend for sending. Both providers require an app-specific password when two-factor authentication is enabled.

Can himalaya send emails with attachments?

Yes, himalaya composes rich emails using MML (MIME Meta Language). Use <#part filename=/path/to/file.pdf> tags in the message body to attach files, and multipart blocks for mixed text and attachment content.

Does himalaya support multiple email accounts?

Yes, define multiple [accounts.name] sections in config.toml and mark one as default. Switch between accounts at runtime with the --account flag, for example himalaya --account work envelope list.

How do I store email passwords securely for himalaya?

Avoid raw passwords in config; use backend.auth.cmd to fetch credentials from a password manager like pass, or use backend.auth.keyring with the system keyring. OAuth2 token-based authentication is also supported for compatible providers.