Himalaya Mail

Overview

Use this skill to run email workflows through the himalaya CLI with a safety-first pattern:

discover exact commands from local help,
execute non-destructive actions,
require confirmation for destructive actions.

Inputs To Confirm Up Front

Before running anything beyond --help, ask for or infer (then confirm) these:

Config path: default ~/.wegent-executor/mail/config.toml
Account: which configured account to use (if more than one)
Folder/mailbox: default should be explicit (e.g. INBOX)
Scope limits: default list size (e.g. 20) and whether to include message bodies
Sent folder name: do not assume Sent; use the server's actual folder name (e.g. Sent, Sent Messages, 已发送邮件)
Compose/send: always confirm the account used for SMTP and headers (use -a <account> for message compose/send commands)

Workflow

1. Resolve Config Source First

Prefer private local config files instead of repository-stored credentials.

Use this config path (default):

himalaya -c ~/.wegent-executor/mail/config.toml account list

Treat .wegent-executor/mail/config.toml as $HOME/.wegent-executor/mail/config.toml.

Always run commands with -c ~/.wegent-executor/mail/config.toml unless the user explicitly asks for another config path.

1.1 Resolve Real Folder Names (Critical For Non-English Mailboxes)

Folder names are server-defined and often localized (for example 已发送邮件, 已删除邮件). Never hardcode Sent/Trash. Before any move/copy/save-to-sent behavior, list folders and pick the exact name shown by the server.

First, discover the folder-list subcommand via local help (see step 2). Then list folders for the selected account and use the exact folder name from the CLI output in subsequent commands.

2. Discover Exact Command Shape

Himalaya command structures can vary by version. Always inspect local help before execution:

himalaya --help
himalaya <subcommand> --help

For nested commands, continue drilling down until flags and required args are explicit.

3. Perform Non-Destructive Operations First

Prefer this order:

Account/mailbox/folder discovery
Message listing
Message read/show
Search/filter
Draft/compose preview
Send or state-changing operations (confirmation required)

4. Execute Destructive Operations Safely

For operations that may send externally, delete, move, expunge, or mutate message state (including read/unread and flags):

List candidate message IDs first.
Ask for explicit confirmation.
Execute only confirmed IDs.

himalaya -c ~/.wegent-executor/mail/config.toml envelope list -a <account> -f <folder> -s 20
himalaya -c ~/.wegent-executor/mail/config.toml message <destructive-subcommand> -a <account> -f <folder> <id...>

Confirmation prompt template (use literally, and wait for user response):

"About to run: . Targets: account=, folder=, ids=[...]. Reply with CONFIRM to proceed, or tell me what to change."

5. Report Results Clearly

After command execution, return:

Context (account/folder)
Result (counts, IDs, subject lines, status)
Next safest action

Safety Rules

Never run send/delete/move/expunge/flag-changing operations without confirmation.
Prefer showing candidate IDs before any bulk action.
Default to headers/envelopes only; do not print full message bodies unless the user explicitly asks.
Do not echo tokens/passwords/config contents into chat.
Do not download/open attachments unless the user explicitly asks and the destination path is clear.
For listing/search, default to -s 20 (or the closest equivalent in the local CLI).
For bulk operations, require an explicit list of IDs; avoid "all in folder" actions unless the user insists and confirms.
If command shape is uncertain, stop and re-check --help instead of guessing.

Address Defaults (Compose/Send)

Default for AI-authored emails: generate then send via templates (pre-fills correct From: from config):

himalaya -c ~/.wegent-executor/mail/config.toml template write -a <account> \
  -H 'To: <...>' -H 'Subject: ...' 'body...' \
| himalaya -c ~/.wegent-executor/mail/config.toml template send -a <account>

Always pass -a <account> for compose/send.
Do not use himalaya message send unless the user explicitly asks to send a raw RFC5322/MIME message; then validate From: exactly matches the selected account email = "..." from ~/.wegent-executor/mail/config.toml (no typos, no missing TLD).

Common Failure Handling

Basic sanity: command -v himalaya, himalaya --version, himalaya --help.
Config/auth/network: show the exact CLI error; confirm -c ~/.wegent-executor/mail/config.toml and -a <account> are correct.
Diagnose: himalaya -c ~/.wegent-executor/mail/config.toml account doctor <account>.

himalaya-mail