himalaya

Send, receive, search, and manage email from the terminal via himalaya CLI.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill himalaya-tapway
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: himalaya
Source: https://github.com/tapway/shogun-os/tree/main/skills/general/email/himalaya
Command: npx skills add https://github.com/tapway/shogun-os --skill himalaya-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Agents and operators often need to read, search, and reply to email without opening a GUI mail client. This Skill provides terminal-based email operations through the himalaya CLI, enabling automated email workflows directly from the command line. ## Core Features & Use Cases - Inbox Reading & Listing: List recent emails from any folder with pagination and read full message content by ID. - Search & Filtering: Query emails by sender, subject, or date using himalaya's search syntax. - Sending & Replying: Compose and send emails with subject and body directly from the terminal. - Use Case: An agent monitors the INBOX for invoice emails, searches with subject:invoice, reads matching messages, and sends payment confirmation replies automatically. ## Quick Start Ask the agent to list the ten most recent emails in your INBOX and read the latest message from a specific sender.

Frequently Asked Questions about himalaya

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

FAQPage Schema
How do I send email from the command line with himalaya?▼

Use himalaya send with --to, --subject, and --body flags to compose and send a message directly from the terminal. The account must be configured in ~/.config/himalaya/config.toml with valid SMTP credentials.

How to search emails by subject or sender using himalaya?▼

Run himalaya list with the --query flag, for example --query "subject:invoice", to filter messages in a folder. You can combine folder selection with --folder to narrow the search scope.

What are the prerequisites for using himalaya CLI?▼

Install himalaya via cargo install himalaya or a package manager, then configure an email account in ~/.config/himalaya/config.toml with working IMAP and SMTP credentials.

When should I not use himalaya for email workflows?▼

Avoid himalaya for calendar management, which belongs to tools like google-workspace, and for complex templated email campaigns or CRM communication, which are better handled by dedicated email or CRM bridge skills.

Why does himalaya fail to list or send emails?▼

Failures usually stem from missing or incorrect IMAP/SMTP credentials in the config.toml file, or himalaya not being installed on the system. Verify the configuration and installation before retrying.