himalaya

Manage IMAP and SMTP email from the shell using the Himalaya CLI.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill himalaya-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: himalaya
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/himalaya
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill himalaya-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reading, searching, and organizing email usually requires a graphical mail client, which breaks terminal-based and AI-assisted workflows. This Skill lets you perform full email operations—listing envelopes, reading messages, composing, replying, forwarding, moving, and deleting—directly through the himalaya command-line tool over standard IMAP/SMTP protocols. ## Core Features & Use Cases - Read and search mail: List folders and envelopes, read messages by ID, and filter by sender or subject (e.g., himalaya envelope list from [email protected] subject invoice). - Compose rich messages: Write, reply, and forward emails using MML (MIME Meta Language) for attachments, HTML bodies, and inline images, with detailed guidance in the bundled references. - Organize mailboxes: Copy, move, and delete messages, and add or remove flags like seen across multiple configured accounts. - Use Case: Ask the assistant to find all unread invoices from a vendor, read the latest one, and draft a reply with an attached signed document—all without leaving the terminal. ## Quick Start Ask the assistant to list your unread emails with himalaya and summarize the three most recent messages from your inbox.

Frequently Asked Questions about himalaya

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

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

Use himalaya envelope list to view messages and himalaya message read <id> to open one. You can filter by sender or subject, for example: himalaya envelope list from [email protected] subject invoice.

How do I send an email with attachments using himalaya?

Compose the message in MML syntax, adding parts like <#part filename=/path/to/file.pdf> for attachments, then send with himalaya template send. The references/message-composition.md file documents the full MML tag syntax.

Does himalaya support Gmail and iCloud accounts?

Yes, himalaya works with Gmail and iCloud over IMAP/SMTP using app-specific passwords. Gmail requires an App Password when 2FA is enabled, and iCloud requires one generated at appleid.apple.com.

How do I manage multiple email accounts with himalaya?

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

How should I store email passwords for himalaya securely?

Avoid raw passwords in the config file. Use backend.auth.cmd to fetch credentials from a password manager like pass, or backend.auth.keyring to use the system keyring after running himalaya account configure.