Skip to main content
himalaya 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).
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/kaivyy/kabot --skill himalayaThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... Related occupations SOC
Based on SOC occupation classification
More from this repository Inspect and safely update Kabot configuration, model/memory/provider settings, channel account policies, allowlists, and related status or log evidence when debugging why a setting or runtime behavior is wrong.
Use when users ask about current weather, temperature, rain, or near-term forecasts for a real location. Not for historical weather archives, official severe-weather alerts, aviation, marine, or climate-trend analysis.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
name himalaya description 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). homepage https://github.com/pimalaya/himalaya metadata {"kabot":{"emoji":"📧","requires":{"bins":["himalaya"]},"install":[{"id":"brew","kind":"brew","formula":"himalaya","bins":["himalaya"],"label":"Install Himalaya (brew)"}]}}
Himalaya Email CLI
Himalaya is a CLI email client that lets you manage 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 to verify)
A configuration file at ~/.config/himalaya/config.toml
IMAP/SMTP credentials configured (password stored securely)
Configuration Setup
Run the interactive wizard to set up an account:
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
List Folders
List Emails List emails in INBOX (default):
List emails in a specific folder:
himalaya envelope list --folder "Sent"
himalaya envelope list --page 1 --page-size 20
Search Emails himalaya envelope list from john@example.com subject meeting
Read an Email Read email by ID (shows plain text):
himalaya message export 42 --full
Reply to an Email Interactive reply (opens $EDITOR):
himalaya message reply 42
himalaya message reply 42 --all
Forward an Email himalaya message forward 42
Write a New Email Interactive compose (opens $EDITOR):
Send directly using template:
cat << 'EOF' | himalaya template send
From: you@example.com
To: recipient@example.com
Subject: Test Message
Hello from Himalaya!
EOF
himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"
Move/Copy Emails himalaya message move 42 "Archive"
himalaya message copy 42 "Important"
Delete an Email himalaya message delete 42
Manage Flags himalaya flag add 42 --flag seen
himalaya flag remove 42 --flag seen
Multiple Accounts himalaya --account work envelope list
Attachments Save attachments from a message:
himalaya attachment download 42
Save to specific directory:
himalaya attachment download 42 --dir ~/Downloads
Output Formats Most commands support --output for structured output:
himalaya envelope list --output json
himalaya envelope list --output plain
Debugging RUST_LOG=debug himalaya envelope list
Full trace with backtrace:
RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list
Tips
Use himalaya --help or himalaya <command> --help for detailed usage.
Message IDs are relative to the current folder; re-list after folder changes.
For composing 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.
