What makes Himalaya notable?

1K downloads. Trust evidence available

How should Himalaya be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Himalaya

Expert guidance for querying, writing, and managing emails using the `himalaya` CLI. Use this skill whenever the user wants to list emails, search envelopes,...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.0k

Updated

Oct 11, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.0release · observed Apr 19, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: medium.

clawhub skill install s178xp167x6qef16anv6t2zqfh83gha3:himalaya-skill

Install using `clawhub skill install s178xp167x6qef16anv6t2zqfh83gha3:himalaya-skill` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/bird-frank/himalaya-skill before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-bird-frank-himalaya-skill/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

18,450 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: himalaya
description: |
  Expert guidance for querying, writing, and managing emails using the `himalaya` CLI.
  Use this skill whenever the user wants to list emails, search envelopes, compose messages,
  manage flags/folders, or execute any himalaya command. Also trigger when the user mentions
  "email CLI", "terminal email", "manage emails from command line", or references the
  Himalaya mail client. This skill provides the full query DSL specification, command
  patterns, and best practices for the himalaya email CLI.
---

# Himalaya CLI Expert

This skill makes you an instant expert on the [Himalaya](https://github.com/pimalaya/himalaya)
command-line email client. Himalaya is a stateless CLI (not a TUI) that lets users manage emails
via shell commands.

## When this skill applies

Use this skill for ANY task involving:
- Listing, searching, or sorting emails (`himalaya envelope list|thread`)
- Reading, writing, replying to, or forwarding messages (`himalaya message ...`)
- Managing flags (`himalaya flag ...`)
- Managing folders/mailboxes (`himalaya folder ...`)
- Message templates and attachments (`himalaya template ...`, `himalaya attachment ...`)
- Interpreting or constructing Himalaya query DSL strings

## Architecture overview

Himalaya CLI is organized around nouns:

```
himalaya <noun> <verb> [args...]
```

Key nouns:
- `envelope` (aliases: `envelopes`) — email envelopes (metadata, no body)
- `message` (aliases: `msg`, `msgs`, `messages`) — full email messages
- `flag` (aliases: `flags`) — message flags (seen, answered, flagged, deleted…)
- `folder` (aliases: `folders`, `mailbox`, `mailboxes`, `mbox`, `mboxes`) — mailboxes
- `template` (aliases: `tpl`, `tpls`, `templates`) — message templates
- `attachment` (aliases: `attachments`) — message attachments
- `account` (aliases: `accounts`) — account configuration

Global flags (available on all commands):
- `--config <PATH>` — override config file path
- `--output json` / `--output plain` — choose output format
- `--quiet`, `--debug`, `--trace` — logging levels

Common per-command flags:
- `-a <NAME>` / `--account <NAME>` — target a specific configured account
- `-f <NAME>` / `--folder <NAME>` — target a specific folder

## Querying emails: envelope commands

The most common operation is listing envelopes. Read the full Query DSL reference
(`references/query_dsl.md`) **whenever the user asks anything about search, filter, sort,
or list queries**.

### Essential commands

```bash
# List all envelopes in the default folder
himalaya envelope list

# List envelopes in a specific folder, page 2, 20 per page
himalaya envelope list -f Archives.FOSS --page 2 --page-size 20

# Thread view for envelopes matching a query
himalaya envelope thread subject "product requirement"
```

### Query DSL quick reference

A query string has the form:

```
[filter-query] [order by sort-query]
```

**Filter conditions:**
- `date <yyyy-mm-dd>` — exact date match
- `before <yyyy-mm-dd>` — strictly before

_meta.json

{
  "ownerId": "kn792wn2t4x4kdq3j345twmwv182x5m7",
  "slug": "himalaya-skill",
  "version": "1.0.0",
  "publishedAt": 1776574009995
}

references/query_dsl.md

# Himalaya 邮件查询使用指南

## 概述

Himalaya 的 `envelope list` 和 `envelope thread` 命令支持一套专门设计的查询 DSL（领域特定语言），用于**筛选**和**排序**邮件。你的查询字符串会被 Himalaya 解析成 AST，最终转换为 IMAP `SEARCH` / `SORT` 命令发送给邮件服务器。

> **注意**：Himalaya 的查询语法是高层封装，并非直接使用 IMAP 原始关键字，但底层会映射为 IMAP 搜索条件。

---

## 查询语法结构

一条完整查询由 **过滤条件** 和 **排序条件** 组成，两者可选：

```
[filter-query] [order by sort-query]
```

- `filter-query`：指定筛选条件（可选）
- `sort-query`：指定排序规则（可选）
- 若两者同时存在，**过滤条件必须写在 `order by` 前面**

---

## 过滤条件语法

### 基本形式

过滤条件由**条件**和**运算符**组合而成，支持使用括号 `()` 改变优先级。

### 可用的条件

| Himalaya 语法 | 含义 | 对应 IMAP 搜索键 | 示例 |
|--------------|------|-----------------|------|
| `date <yyyy-mm-dd>` | 日期精确匹配 | `SENTON` | `date 2025-04-12` |
| `before <yyyy-mm-dd>` | 日期严格小于 | `SENTBEFORE` | `before 2025-04-01` |
| `after <yyyy-mm-dd>` | 日期严格大于 | `SENTSINCE` (+1天) | `after 2025-04-01` |
| `from <pattern>` | 发件人匹配 | `FROM` | `from [email protected]` |
| `to <pattern>` | 收件人匹配 | `TO` | `to [email protected]` |
| `subject <pattern>` | 主题匹配 | `SUBJECT` | `subject "会议通知"` |
| `body <pattern>` | 正文内容匹配 | `BODY` | `body 项目进度` |
| `flag <flag>` | 邮件标志匹配 | 对应状态标志 | `flag seen` |

### 可用的运算符

| 运算符 | 优先级 | 含义 | 示例 |
|--------|--------|------|------|
| `not` | 最高 | 取反 | `not from [email protected]` |
| `and` | 中 | 两者都必须满足 | `from boss and subject 周报` |
| `or` | 最低 | 满足其一即可 | `from alice or from bob` |

**优先级规则**：`not` > `and` > `or`，复杂查询建议用括号明确优先级。

### 模式匹配中的空格与引号

- **引号**：用双引号包裹含空格的字符串，如 `subject "foo bar"`
- **转义**：无引号模式下可用反斜杠转义空格和括号，如 `subject foo\ bar`
- 引号内可转义 `\"` 和 `\\`

---

## 排序条件语法

使用关键字 `order by` 开头，后跟一个或多个排序字段，每个字段可指定 `asc` 或 `desc`。

### 可用的排序字段

| 字段 | 排序依据 |
|------|---------|
| `date` | 邮件日期 |
| `from` | 发件人 |
| `to` | 收件人 |
| `subject` | 主题 |

### 默认顺序

- 不指定时默认为 **升序** (`asc`)
- 多字段排序时按声明顺序依次应用

---

## 组合查询示例

### 纯过滤
```bash
# 主题包含"周报"且正文包含"进度"
himalaya envelope list subject 周报 and body 进度

# 来自老板或 CEO 的邮件
himalaya envelope list from [email protected] or from [email protected]

# 不是已删除的邮件（假设服务器支持相关标志）
himalaya envelope list not flag deleted
```

### 纯排序
```bash
# 按日期降序排列（最新的在前）
himalaya envelope list order by date desc

# 先按发件人升序，再按主题降序
himalaya envelope list order by from asc subject desc
```

### 过滤 + 排序
```bash
# 查找未读邮件，按日期降序排列
himalaya envelope list not flag seen order by date desc

# 查找4月以来的重要邮件，先按发件人排序再按日期排序
himalaya envelope list after 2025-04-01 and subject 重要 order by from date desc
```

---

## 常见场景命令示例

### 1. 查看未读邮件
```bash
himalaya envelope list not flag seen
himalaya envelope list not flag seen order by date desc
```

### 2. 查看来自特定发件人的邮件
```bash
himaya envelope list from [email protected]
himalaya envelope list from [email protected] order by date desc
```

### 3. 按日期范围查找
```bash
# 2025年4月1日至4月10日（before 不包含边界）
himalaya envelope list after 2025-03-31 and before 2025-04-11

# 2025年4月12日当天的邮件
himalaya envelope list date 2025-04-12
```

### 4. 主题搜索
```bash
# 简单关键词
himalaya envelope list subject 项目

# 带空格的短语
himalaya envelope list subject "会议通知"

# 转义空格（等效写法）
himalaya envelope list subject 会议\ 通知
``

skill-card.md

## Description:

Expert guidance for querying, writing, and managing emails using the `himalaya` CLI.

This skill is ready for commercial/non-commercial use.

## Publisher:

[bird-frank](https://clawhub.ai/user/bird-frank)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and email users use this skill to construct and review Himalaya CLI commands for listing and searching email, composing messages, and managing flags, folders, templates, and attachments.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Generated guidance may include send, reply, forward, delete, purge, or expunge email actions.

Mitigation: Review account, folder, message IDs, recipients, and all send or destructive actions before allowing any generated command to run.

Risk: Broad email search and management commands may target the wrong account, folder, message, or recipient if parameters are incorrect.

Mitigation: Validate generated Himalaya query strings, account flags, folder flags, message IDs, and recipients against the intended mailbox before execution.

## Reference(s):

- [Bundled Query DSL Reference](references/query_dsl.md)
- [Himalaya Repository](https://github.com/pimalaya/himalaya)

## Skill Output:

**Output Type(s):** [Shell commands, Configuration instructions, Guidance]

**Output Format:** [Markdown with inline bash code blocks]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Single-response guidance with commands for a user to review before execution.]

## Skill Version(s):

1.0.0 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

evals/evals.json

{
  "skill_name": "himalaya",
  "evals": [
    {
      "id": 1,
      "prompt": "I need to find all unread emails from my boss ([email protected]) in Himalaya, sorted with the newest first. Give me the exact command to run.",
      "expected_output": "The assistant returns the correct himalaya CLI command using 'not flag seen', 'from [email protected]', and 'order by date desc'.",
      "files": [],
      "expectations": [
        "The output contains the command 'himalaya envelope list'",
        "The output includes 'not flag seen' or equivalent unread filter",
        "The output includes 'from [email protected]'",
        "The output includes 'order by date desc'",
        "The command is syntactically valid for the Himalaya query DSL"
      ]
    },
    {
      "id": 2,
      "prompt": "Show me how to compose and send an email to the [email protected] with the subject 'Weekly Sync' using himalaya. Include any relevant flags or options I should know about.",
      "expected_output": "The assistant explains how to use 'himalaya message write' with --to and --subject flags, and describes the $EDITOR workflow.",
      "files": [],
      "expectations": [
        "The output mentions 'himalaya message write'",
        "The output includes '--to [email protected]' or equivalent",
        "The output includes '--subject \"Weekly Sync\"' or equivalent",
        "The output mentions $EDITOR or interactive composition",
        "The output describes the template header format (From, To, Subject, blank line, body)"
      ]
    },
    {
      "id": 3,
      "prompt": "Using himalaya, how do I search for emails with the subject ' invoices ' (with a space) sent after 2025-03-01, and also show them in the Archive folder instead of INBOX? I want 15 per page and page 2.",
      "expected_output": "The assistant constructs a single himalaya envelope list command with proper quoting for the spaced subject, the after date filter, folder flag, pagination flags, and page size.",
      "files": [],
      "expectations": [
        "The output contains 'himalaya envelope list'",
        "The output includes a folder flag like '-f Archive' or '--folder Archive'",
        "The output includes '--page 2'",
        "The output includes '--page-size 15' or '-s 15'",
        "The output includes 'after 2025-03-01'",
        "The subject query correctly quotes or escapes the space in 'invoices'"
      ]
    }
  ]
}

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.