himalaya

What This Skill Does

Himalaya is a powerful command-line interface (CLI) tool designed to streamline email management directly from your terminal. It supports multiple email protocols like IMAP and SMTP, and integrates with backends such as Notmuch for advanced searching. With Himalaya, you can perform a wide array of email operations without ever leaving your command-line environment. This includes listing folders, viewing email summaries (envelopes), reading full email content, composing new messages, replying to or forwarding existing emails, searching through your inbox using various criteria, moving or copying emails between folders, deleting messages, and managing email flags (like 'seen' or 'flagged'). It also offers robust support for composing emails using the MIME Meta Language (MML) and handling multiple email accounts seamlessly.

Installation

To install the Himalaya skill, use the following command:

clawhub install openclaw/openclaw/skills/himalaya

Ensure you have the Himalaya CLI installed on your system and a configuration file set up at ~/.config/himalaya/config.toml with your IMAP/SMTP credentials. You can set up your account interactively using himalaya account configure or by manually creating the configuration file.

Use Cases

• Efficient Email Triage: Quickly review and manage your inbox without switching to a graphical client.
• Automated Email Tasks: Integrate Himalaya into scripts for automated email processing, such as archiving or categorizing messages.
• Remote Server Management: Manage emails on a server directly via SSH without needing a desktop environment.
• Privacy-Conscious Communication: Compose and send emails with fine-grained control over headers and content using MML.
• System Notifications: Script email sending for system alerts or status updates.
• Offline Email Access: Leverage Notmuch backend for fast, offline searching of your email archive.

Example Prompts

1. "List all emails from '[email protected]' with the subject 'Project Update' in my inbox."
2. "Read email with ID 123 and show its raw MIME content."
3. "Compose a new email to '[email protected]' with the subject 'Daily Standup Notes' and body 'Here are the notes for today.' then send it."

Tips & Limitations

• Secure Authentication: Always use secure methods for storing your email passwords, such as a password manager or encrypted commands (pass show ...). Avoid hardcoding credentials.
• MML for Composition: Familiarize yourself with the MIME Meta Language (MML) for advanced email composition, including attachments and complex formatting.
• Configuration is Key: Ensure your config.toml file is correctly set up for all desired accounts and backends. Refer to the official documentation for detailed configuration options.
• Backend Choice: Consider the backend that best suits your needs. IMAP/SMTP are standard, while Notmuch offers powerful offline search capabilities.
• Error Handling: Be prepared to handle potential errors related to network connectivity, authentication, or malformed email data. The CLI provides detailed error messages.