himalaya

Manage IMAP/SMTP email from the terminal with structured JSON output.

Updated May 4, 2026

Search Tags:#email #smtp #json output #imap #message search #terminal cli #compose mml

Ready to run

npx skills add https://github.com/JamesFincher/gengar --skill himalaya-jamesfincher

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: himalaya
Source: https://github.com/JamesFincher/gengar/tree/main/skills/email/himalaya
Command: npx skills add https://github.com/JamesFincher/gengar --skill himalaya-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It eliminates slow, UI-heavy email workflows by letting you list, search, read, compose, and send messages directly from your terminal.

Core Features & Use Cases

IMAP/SMTP Email Management: Browse folders, list messages, read email content, export MIME, and delete/move/copy messages.
Fast Searching & Output for Automation: Filter messages by sender/subject and use structured output (including JSON) for downstream parsing.
Terminal Composition via Templates: Reply/forward and send reliably using piped input and MML (MIME Meta Language) to generate correct MIME structures.

Quick Start

Tell Gengar to list emails in your default INBOX and return structured results for easy follow-up: run himalaya envelope list --output json.

Frequently Asked Questions about himalaya

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

FAQPage Schema

How do I manage IMAP email directly from the terminal?▼

You can manage IMAP email from the terminal by using command-line commands to list, search, read, and delete messages without a graphical client. This requires a valid configuration file with your backend credentials.

Can I get JSON output for email messages to use in automation scripts?▼

Yes, you can output structured JSON for email messages to facilitate downstream parsing in automation scripts. Running the envelope list command with the JSON output flag provides consistent structured data.

How do I compose and send SMTP email using a terminal CLI?▼

You compose and send SMTP email by piping input and using MML (MIME Meta Language) templates to generate the correct MIME structures. This allows reliable replies and forwarding directly from the command line.

Do I need a specific config file setup to use terminal email management?▼

Yes, you need a working email client installation and a valid configuration file located at the default config directory with your IMAP and SMTP backend credentials before managing messages.

What is the best way to triage my inbox without a heavy graphical email client?▼

Terminal-based email management is the best way to triage your inbox without UI-heavy clients, allowing you to quickly filter messages by sender or subject and read content directly in the terminal.