himalaya-cli

What This Skill Does

The himalaya-cli skill enables your AI agent to function as a powerful, terminal-based email manager. By leveraging the Himalaya Email CLI, the agent can interact with your IMAP and SMTP servers to perform essential communication tasks. It is designed for users who prioritize privacy, speed, and terminal workflows. With this skill, the agent can list envelopes, search through deep email archives, read specific messages, and handle outgoing correspondence through composition, replies, and forwarding. It supports complex backend configurations, allowing it to interface with existing email infrastructure while keeping credentials secure via external command execution like pass or keyring.

Installation

To integrate this capability into your OpenClaw environment, ensure the Himalaya CLI is installed on your host machine and verify it with 'himalaya --version'. Once confirmed, initialize your configuration at ~/.config/himalaya/config.toml, setting up your IMAP/SMTP accounts. Finally, install the skill via the OpenClaw terminal command: clawhub install openclaw/skills/skills/cohenyehonatan/himalaya-cli.

Use Cases

This skill is perfect for automated email triaging and rapid communication management. Use it to scan for specific subject lines, archive old messages automatically, or draft replies based on templates. It is particularly useful for developers or system administrators who prefer processing emails via text-based streams and require a lightweight, scriptable interface for their inbox rather than heavy GUI clients.

Example Prompts

1. "Check my inbox for any emails from the support team regarding the server migration and summarize the latest one."
2. "Find the email with the subject 'Project Timeline' from last month and forward it to my project manager at [email protected]."
3. "List the 10 most recent emails in my 'Work' folder and flag the unread ones for my review."

Tips & Limitations

Note that Himalaya requires the correct subcommand structure. Avoid top-level commands like 'himalaya list'; always specify the domain, such as 'himalaya envelope list' or 'himalaya message read'. Ensure your configuration file uses secure methods for password handling (e.g., 'pass show') rather than plaintext to maintain system integrity. The skill relies on your system's default editor for interactive composition tasks, so ensure environment variables like EDITOR are set correctly for the agent to handle message writing smoothly.