himalaya

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

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill himalaya-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: himalaya
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/email/himalaya
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill himalaya-kaminocorp

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 list, read, reply to, forward, search, and organize emails entirely from the command line over standard IMAP/SMTP protocols. ## Core Features & Use Cases - Full email operations: List envelopes, read messages, search by sender or subject, move/copy/delete messages, and manage flags across multiple accounts and folders. - Non-interactive composition: Send, reply, and forward by piping MML (MIME Meta Language) templates via stdin, supporting attachments, HTML parts, and inline images. - Structured output: Use --output json for machine-parseable results, ideal for agent-driven automation. - Use Case: Ask the agent to check your inbox for unread messages from a client, summarize them, and send a reply — all without leaving the terminal. ## Quick Start Ask the agent to list the ten most recent emails in your inbox using himalaya 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 send an email from the command line with himalaya?▼

Pipe a message with headers and body into himalaya template send via stdin, for example using a heredoc with From, To, and Subject headers. This non-interactive approach avoids opening an editor and works reliably in automated environments.

How do I configure himalaya for Gmail or iCloud?▼

Create a config.toml under ~/.config/himalaya with an account block specifying the provider's IMAP and SMTP hosts, ports, and encryption. Gmail and iCloud both require an app-specific password when two-factor authentication is enabled.

Does himalaya support multiple email accounts?▼

Yes, himalaya supports multiple accounts defined as separate blocks in config.toml. List them with himalaya account list and select one at runtime with the --account flag, while one account can be marked as default.

Can himalaya store passwords securely instead of plaintext?▼

Yes, himalaya supports password commands such as pass show, system keyring integration, and OAuth2 token commands. Raw passwords in the config file are supported but recommended only for testing.

How do I add attachments to emails sent with himalaya?▼

Use MML syntax in the message body with a part tag specifying the filename, such as <#part filename=/path/to/file.pdf>. Himalaya compiles MML parts into proper MIME attachments when sending.

Why does himalaya message write open an editor instead of sending?▼

Without piped input, himalaya message write launches $EDITOR for interactive composition. For scripted or agent-driven use, pipe the message via stdin to himalaya template send or pass headers with the -H flag.