himalaya

steipete/clawdis

IMAP/SMTP email CLI for listing, reading, searching, composing, and organizing messages from the shell.

What is himalaya?

Himalaya is a command-line interface for email operations over IMAP and SMTP protocols. Use it to manage mailboxes, read and search messages, compose and reply to emails, and organize messages across folders—all from the terminal.

List folders and envelopes in IMAP mailboxes
Read and search messages by sender, subject, and other criteria
Compose new messages, replies, and forwards with MML syntax support
Attach files and create rich-text messages
Copy, move, and delete messages between folders
Flag messages as seen or unseen

How to install himalaya

npx skills add https://github.com/steipete/clawdis --skill himalaya

Prerequisites

Himalaya CLI installed (via brew or other package manager)
IMAP/SMTP email account configured in ~/.config/himalaya/config.toml
Credentials stored in a password manager or system keyring (not in plain text)

Claude Code

Cursor

Windsurf

Cline

How to use himalaya

1.Run `himalaya --version` to verify installation
2.Run `himalaya account configure` to set up your email account
3.Use `himalaya folder list` to see available mailboxes
4.Use `himalaya envelope list` to view messages, optionally filtering by sender or subject
5.Use `himalaya message read <id>` to read a specific message
6.Use `himalaya message write` or `himalaya template write` to compose new messages
7.Use `himalaya message reply <id>` or `himalaya message forward <id>` for responses
8.Use `himalaya message copy/move/delete <id> <folder>` to organize messages

Use cases

Good for

Automating email workflows and batch operations from scripts
Reading and responding to emails without leaving the terminal
Searching and filtering messages by sender or subject
Managing multiple email accounts from a single CLI interface
Integrating email operations into agent-driven automation tasks

Who it's for

Terminal-focused developers and power users
DevOps engineers automating email notifications and alerts
Agents and scripts requiring programmatic email access
Users managing multiple email accounts

himalaya FAQ

How do I configure my email account?

Run `himalaya account configure` and follow the prompts. Configuration is stored in ~/.config/himalaya/config.toml. Use a password manager or system keyring for credentials rather than storing secrets in plain text.

How do I search for messages?

Use `himalaya envelope list` with filters like `from alice@example.com subject invoice` to search by sender, subject, or other criteria.

How do I attach files to messages?

Use MML (MIME Multipart Language) syntax when composing. Refer to references/message-composition.md for the exact syntax and examples.

Can I manage multiple email accounts?

Yes. Use the `--account` flag to switch between configured accounts when running commands.

What safety precautions should I take?

Always confirm before sending, deleting, or moving many messages at once. Quote exact message IDs in summaries and avoid pasting secrets into chat or logs.

Full instructions (SKILL.md)

Source of truth, from steipete/clawdis.

name: himalaya description: "Himalaya CLI for IMAP/SMTP mail: list, read, search, compose, reply, forward, copy, move, delete." homepage: https://github.com/pimalaya/himalaya metadata: { "openclaw": { "emoji": "📧", "requires": { "bins": ["himalaya"] }, "install": [ { "id": "brew", "kind": "brew", "formula": "himalaya", "bins": ["himalaya"], "label": "Install Himalaya (brew)", }, ], }, }

Himalaya

Use himalaya for IMAP/SMTP email from shell.

References

references/configuration.md: account config, auth, backend setup.
references/message-composition.md: MML compose syntax.

Setup

himalaya --version
himalaya account configure

Config path: ~/.config/himalaya/config.toml.

Prefer password managers/keyrings for credentials; do not paste secrets into chat/logs.

Read/search

himalaya folder list
himalaya envelope list
himalaya message read <id>
himalaya envelope list from alice@example.com subject invoice

Write

himalaya message write
himalaya template write
himalaya template send < /tmp/message.txt
himalaya message reply <id>
himalaya message forward <id>

Use MML for attachments and rich messages; read references/message-composition.md first.

Organize

himalaya message copy <id> <folder>
himalaya message move <id> <folder>
himalaya message delete <id>
himalaya flag add <id> --flag seen
himalaya flag remove <id> --flag seen