himalaya

Manage terminal-based email over IMAP and SMTP with JSON output.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill himalaya-zardli1115
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: himalaya
Source: https://github.com/ZardLi1115/zedclaw/tree/main/skills/email/himalaya
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill himalaya-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Himalaya eliminates the friction of checking and composing email by letting you do common IMAP/SMTP tasks directly from your terminal instead of juggling a web client.

Core Features & Use Cases

  • Read and search email from the CLI: List folders/envelopes, search by sender/subject, and read or export messages (including raw MIME).
  • Compose and send reliably: Build messages using templates and pipe stdin for non-interactive workflows, including reply/forward flows.
  • Move, delete, and manage state: Move/copy messages between folders, delete by ID, and add/remove message flags like seen.
  • Agent-friendly structured output: Use JSON output to make results easy for automation (e.g., runtime status tools or PR-agent workflows).

Quick Start

Send a new email non-interactively by piping a message into Himalaya’s template sender, for example: pipe a prepared email with From/To/Subject and body into himalaya template send.

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 terminal using IMAP and SMTP?

You can send email from the terminal by piping a prepared message with headers and body into the template sender. This requires a valid configuration file with IMAP and SMTP backend credentials to process non-interactive message creation via stdin.

Can I search and read email messages from the CLI?

Yes, you can search and read email messages directly from the CLI. The tool lists folders and envelopes, allows searching by sender or subject, and reads or exports messages including their raw MIME format.

How do I automate email notifications for agent-driven workflows?

Automate email notifications by leveraging structured JSON output and non-interactive message creation via piped stdin. This allows agent-driven workflows to parse results and trigger template-based email sending reliably.

What configuration is required to manage IMAP email from the terminal?

To manage IMAP email from the terminal, you need the Himalaya CLI installed and a valid configuration file at the default path. This config must contain your IMAP and SMTP backend credentials along with correct folder aliases.

How do I move or delete messages between folders in a terminal email client?

You can move, copy, or delete messages between folders by referencing their message IDs. The tool also supports managing message state by adding or removing flags like seen directly from the CLI.