Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix docs(skills/himalaya): add reading-email guide and query pitfall documentation [1 pull requests]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Add missing documentation for reading emails and a common pitfall with query string handling to the himalaya skill.

Error Message

Wrong - will fail with parse error

+# Wrong - will fail with parse error

Root Cause

Add missing documentation for reading emails and a common pitfall with query string handling to the himalaya skill.

Fix Action

Fixed

Code Example

- `references/configuration.md` (config file setup + IMAP/SMTP authentication)
 - `references/message-composition.md` (MML syntax for composing emails)
+- `references/reading-email.md` (reading, flags, handling forwarded emails)

---

**Pitfall: Query strings with spaces must be quoted:**

---

The himalaya query parser expects spaces to separate operators. Multi-word phrases without quotes are interpreted as separate tokens, causing "found 'C' expected space between filters" errors.

---

--- a/skills/email/himalaya/SKILL.md
+++ b/skills/email/himalaya/SKILL.md
@@ -21,6 +21,7 @@

 - `references/configuration.md` (config file setup + IMAP/SMTP authentication)
 - `references/message-composition.md` (MML syntax for composing emails)
+- `references/reading-email.md` (reading, flags, handling forwarded emails)

 ## Prerequisites

@@ -135,6 +136,18 @@
 himalaya envelope list from john@example.com subject meeting

---

+# Wrong - will fail with parse error
+himalaya envelope list subject Verification Code
+
+# Correct - quoted phrase
+himalaya envelope list 'subject "Verification Code"'
+
RAW_BUFFERClick to expand / collapse

Issue: docs(skills/himalaya): add reading-email guide and query pitfall documentation

Summary

Add missing documentation for reading emails and a common pitfall with query string handling to the himalaya skill.

Changes

1. New reference file: references/reading-email.md

Add a new reference file covering:

  • Basic message reading (message read <id>)
  • Full MIME export (message export <id> --full)
  • Reading HTML emails
  • Handling forwarded emails
  • Extracting verification codes from forwarded emails
  • Message flags (list, add, remove)
  • Pagination

2. SKILL.md additions

Add reference to new file:

 - `references/configuration.md` (config file setup + IMAP/SMTP authentication)
 - `references/message-composition.md` (MML syntax for composing emails)
+- `references/reading-email.md` (reading, flags, handling forwarded emails)

Add pitfall about query string quoting:

**Pitfall: Query strings with spaces must be quoted:**

```bash
# Wrong - will fail with parse error
himalaya envelope list subject Verification Code

# Correct - quoted phrase
himalaya envelope list 'subject "Verification Code"'

The himalaya query parser expects spaces to separate operators. Multi-word phrases without quotes are interpreted as separate tokens, causing "found 'C' expected space between filters" errors.


## Motivation

The himalaya skill currently lacks documentation for:
1. Reading emails - users need to know how to read, export, and handle different email formats
2. Common pitfall with query strings - this is a non-obvious issue that causes confusing parse errors

## Diff

```diff
--- a/skills/email/himalaya/SKILL.md
+++ b/skills/email/himalaya/SKILL.md
@@ -21,6 +21,7 @@

 - `references/configuration.md` (config file setup + IMAP/SMTP authentication)
 - `references/message-composition.md` (MML syntax for composing emails)
+- `references/reading-email.md` (reading, flags, handling forwarded emails)

 ## Prerequisites

@@ -135,6 +136,18 @@
 himalaya envelope list from [email protected] subject meeting

+Pitfall: Query strings with spaces must be quoted: + +bash +# Wrong - will fail with parse error +himalaya envelope list subject Verification Code + +# Correct - quoted phrase +himalaya envelope list 'subject "Verification Code"' + + +The himalaya query parser expects spaces to separate operators...


## New file content

See attached `references/reading-email.md` content below.

---

*Note: This improvement was discovered and documented by a Hermes Agent user. Posting here to contribute back to the upstream project.*

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix docs(skills/himalaya): add reading-email guide and query pitfall documentation [1 pull requests]