🎯

himalaya

🎯Skill

from steipete/clawdis

What it does

Manages emails directly from the terminal using IMAP/SMTP, enabling listing, reading, writing, and organizing emails with multi-account support.

📦

Part of

steipete/clawdis(48 items)

himalaya

Installation

npm installInstall npm package

npm install -g openclaw@latest

git cloneClone repository

git clone https://github.com/openclaw/openclaw.git

pnpmRun with pnpm

pnpm install

📖 Extracted from docs: steipete/clawdis

Need more details? View full documentation on GitHub →

12Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

"CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language)."

Overview

# Himalaya Email CLI

Himalaya is a CLI email client that lets you manage emails from the terminal using IMAP, SMTP, Notmuch, or Sendmail backends.

References

references/configuration.md (config file setup + IMAP/SMTP authentication)
references/message-composition.md (MML syntax for composing emails)

Prerequisites

Himalaya CLI installed (himalaya --version to verify)
A configuration file at ~/.config/himalaya/config.toml
IMAP/SMTP credentials configured (password stored securely)

Configuration Setup

Run the interactive wizard to set up an account:

```bash

himalaya account configure

```

Or create ~/.config/himalaya/config.toml manually:

```toml

[accounts.personal]

email = "you@example.com"

display-name = "Your Name"

default = true

backend.type = "imap"

backend.host = "imap.example.com"

backend.port = 993

backend.encryption.type = "tls"

backend.login = "you@example.com"

backend.auth.type = "password"

backend.auth.cmd = "pass show email/imap" # or use keyring

message.send.backend.type = "smtp"

message.send.backend.host = "smtp.example.com"

message.send.backend.port = 587

message.send.backend.encryption.type = "start-tls"

message.send.backend.login = "you@example.com"

message.send.backend.auth.type = "password"

message.send.backend.auth.cmd = "pass show email/smtp"

```

Common Operations

List Folders

```bash

himalaya folder list

```

List Emails

List emails in INBOX (default):

```bash

himalaya envelope list

```

List emails in a specific folder:

```bash

himalaya envelope list --folder "Sent"

```

List with pagination:

```bash

himalaya envelope list --page 1 --page-size 20

```

Search Emails

```bash

himalaya envelope list from john@example.com subject meeting

```

Read an Email

Read email by ID (shows plain text):

```bash

himalaya message read 42

```

Export raw MIME:

```bash

himalaya message export 42 --full

```

Reply to an Email

Interactive reply (opens $EDITOR):

```bash

himalaya message reply 42

```

Reply-all:

```bash

himalaya message reply 42 --all

```

Forward an Email

```bash

himalaya message forward 42

```

Write a New Email

Interactive compose (opens $EDITOR):

```bash

himalaya message write

```

Send directly using template:

```bash

cat << 'EOF' | himalaya template send

From: you@example.com

To: recipient@example.com

Subject: Test Message

Hello from Himalaya!

EOF

```

Or with headers flag:

```bash

himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"

```

Move/Copy Emails

Move to folder:

```bash

himalaya message move 42 "Archive"

```

Copy to folder:

```bash

himalaya message copy 42 "Important"

```

Delete an Email

```bash

himalaya message delete 42

```

Manage Flags

Add flag:

```bash

himalaya flag add 42 --flag seen

```

Remove flag:

```bash

himalaya flag remove 42 --flag seen

```

Multiple Accounts

List accounts:

```bash

himalaya account list

```

Use a specific account:

```bash

himalaya --account work envelope list

```

Attachments

Save attachments from a message:

```bash

himalaya attachment download 42

```

Save to specific directory:

```bash

himalaya attachment download 42 --dir ~/Downloads

```

Output Formats

Most commands support --output for structured output:

```bash

himalaya envelope list --output json

himalaya envelope list --output plain

```

Debugging

Enable debug logging:

```bash

RUST_LOG=debug himalaya envelope list

```

Full trace with backtrace:

```bash

RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list

```

Tips

Use himalaya --help or himalaya --help for detailed usage.
Message IDs are relative to the current folder; re-list after folder changes.
For composing rich emails with attachments, use MML syntax (see references/message-composition.md).
Store passwords securely using pass, system keyring, or a command that outputs the password.

More from this repository10

🎯

gog🎯Skill

Manages Gmail, Calendar, Drive, Contacts, Sheets, and Docs via CLI with OAuth-based Google Workspace interactions.

🎯

weather🎯Skill

Retrieves current weather and forecasts for any location using free services, with multiple output formats and no API key required.

🎯

summarize🎯Skill

Quickly summarizes URLs, local files, and YouTube links using AI models with flexible extraction options.

🎯

coding-agent🎯Skill

Runs coding agents like Claude Code or Codex in bash with PTY support, enabling programmatic control and background processing.

🎯

mcporter🎯Skill

Streamlines interaction with MCP servers through CLI, enabling listing, configuration, authentication, and direct tool calls via HTTP or stdio.

🎯

apple-reminders🎯Skill

Manages Apple Reminders via CLI, enabling listing, adding, editing, completing, and deleting tasks with flexible date and list filtering.

🎯

gifgrep🎯Skill

Searches and downloads GIFs from Tenor/Giphy with a CLI/TUI, enabling preview, extraction, and easy sharing.

🎯

nano-pdf🎯Skill

Edits PDFs using natural language instructions, allowing precise page-level modifications with simple CLI commands.

🎯

obsidian🎯Skill

Automates interactions with Obsidian vaults, enabling searching, creating, moving, and managing Markdown notes via obsidian-cli.

🎯

peekaboo🎯Skill

Automates macOS UI interactions by capturing screens, targeting elements, driving input, and managing apps via a powerful CLI tool.