How do I install the Himalaya skill?

Run npx skillmds@latest add lidge-jun/himalaya in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Himalaya safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Himalaya?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Himalaya free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Himalaya?

lidge-jun (@lidge-jun) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Himalaya by lidge-jun — Agent Skill

Name: Himalaya
Author: lidge-jun

File contents

Himalaya Email CLI

CLI email client for managing emails from the terminal using IMAP, SMTP, Notmuch, or Sendmail backends.

References

references/configuration.md — config file setup + IMAP/SMTP authentication
references/message-composition.md — MML syntax for composing emails

Prerequisites

Himalaya CLI installed (himalaya --version)
Config file at ~/.config/himalaya/config.toml
IMAP/SMTP credentials configured

Configuration

Run the interactive wizard:

himalaya account configure

Or create ~/.config/himalaya/config.toml manually:

[accounts.personal]
email = "you@example.com"
display-name = "Your Name"
default = true

backend.type = "imap"
backend.host = "imap.example.com"
backend.port = 993
backend.encryption.type = "tls"
backend.login = "you@example.com"
backend.auth.type = "password"
backend.auth.cmd = "pass show email/imap"

message.send.backend.type = "smtp"
message.send.backend.host = "smtp.example.com"
message.send.backend.port = 587
message.send.backend.encryption.type = "start-tls"
message.send.backend.login = "you@example.com"
message.send.backend.auth.type = "password"
message.send.backend.auth.cmd = "pass show email/smtp"

Common Operations

# Folders
himalaya folder list

# List emails (default: INBOX)
himalaya envelope list
himalaya envelope list --folder "Sent"
himalaya envelope list --page 1 --page-size 20

# Search
himalaya envelope list from john@example.com subject meeting

# Read
himalaya message read 42
himalaya message export 42 --full          # raw MIME

# Reply / Forward
himalaya message reply 42
himalaya message reply 42 --all
himalaya message forward 42

# Compose
himalaya message write                     # opens $EDITOR

# Send directly via template
cat << 'EOF' | himalaya template send
From: you@example.com
To: recipient@example.com
Subject: Test Message

Hello from Himalaya!
EOF

# Move / Copy / Delete
himalaya message move 42 "Archive"
himalaya message copy 42 "Important"
himalaya message delete 42

# Flags
himalaya flag add 42 --flag seen
himalaya flag remove 42 --flag seen

# Attachments
himalaya attachment download 42
himalaya attachment download 42 --dir ~/Downloads

Multiple Accounts

himalaya account list
himalaya --account work envelope list

Output Formats

himalaya envelope list --output json
himalaya envelope list --output plain

Debugging

RUST_LOG=debug himalaya envelope list
RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list

Tips

Message IDs are relative to the current folder; re-list after folder changes.
For rich emails with attachments, use MML syntax (see references/message-composition.md).
Store passwords securely using pass, system keyring, or a command that outputs the password.

---name: himalayadescription: CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).---# Himalaya Email CLICLI email client for managing emails from the terminal using IMAP, SMTP, Notmuch, or Sendmail backends.## References- `references/configuration.md` — config file setup + IMAP/SMTP authentication- `references/message-composition.md` — MML syntax for composing emails## Prerequisites1. Himalaya CLI installed (`himalaya --version`)2. Config file at `~/.config/himalaya/config.toml`3. IMAP/SMTP credentials configured## ConfigurationRun the interactive wizard:```bashhimalaya account configure```Or create `~/.config/himalaya/config.toml` manually:```toml[accounts.personal]email = "you@example.com"display-name = "Your Name"default = truebackend.type = "imap"backend.host = "imap.example.com"backend.port = 993backend.encryption.type = "tls"backend.login = "you@example.com"backend.auth.type = "password"backend.auth.cmd = "pass show email/imap"message.send.backend.type = "smtp"message.send.backend.host = "smtp.example.com"message.send.backend.port = 587message.send.backend.encryption.type = "start-tls"message.send.backend.login = "you@example.com"message.send.backend.auth.type = "password"message.send.backend.auth.cmd = "pass show email/smtp"```## Common Operations```bash# Foldershimalaya folder list# List emails (default: INBOX)himalaya envelope listhimalaya envelope list --folder "Sent"himalaya envelope list --page 1 --page-size 20# Searchhimalaya envelope list from john@example.com subject meeting# Readhimalaya message read 42himalaya message export 42 --full # raw MIME# Reply / Forwardhimalaya message reply 42himalaya message reply 42 --allhimalaya message forward 42# Composehimalaya message write # opens $EDITOR# Send directly via templatecat << 'EOF' | himalaya template sendFrom: you@example.comTo: recipient@example.comSubject: Test MessageHello from Himalaya!EOF# Move / Copy / Deletehimalaya message move 42 "Archive"himalaya message copy 42 "Important"himalaya message delete 42# Flagshimalaya flag add 42 --flag seenhimalaya flag remove 42 --flag seen# Attachmentshimalaya attachment download 42himalaya attachment download 42 --dir ~/Downloads```## Multiple Accounts```bashhimalaya account listhimalaya --account work envelope list```## Output Formats```bashhimalaya envelope list --output jsonhimalaya envelope list --output plain```## Debugging```bashRUST_LOG=debug himalaya envelope listRUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list```## Tips- Message IDs are relative to the current folder; re-list after folder changes.- For rich emails with attachments, use MML syntax (see `references/message-composition.md`).- Store passwords securely using `pass`, system keyring, or a command that outputs the password.

Frequently asked questions

Himalaya