Hermes Mail Triage
Freshness check
Before writing or changing any Hermes config, run hermes --version and
hermes update --check, then read
https://github.com/NousResearch/hermes-agent/releases/latest. If the installed
or latest version is newer than 0.23.0, read every release note since 0.23.0
("Upgrade notes" first) and adjust. Never apply guidance from this skill to a
newer version without that check.
Native vs pattern
| Piece | Status in 0.23.0 | Where |
|---|---|---|
| Reading a mailbox | Native: email adapter (IMAP/SMTP, one account per adapter per profile) or the bundled Himalaya email skill (terminal himalaya CLI) |
mailbox-topology.md, hermes-gateways |
| Several mailboxes in one agent | Not documented as native - several profiles, or Himalaya / an MCP mail tool with several accounts | hermes-gateways #several-mailboxes |
| Running every N hours | Native: hermes cron (every 2h) |
hermes-cron |
| Sender authentication for conversations with the agent | Native in the email adapter (acts only on an authenticated From:) |
hermes-gateways |
| Bulk / SPF-DKIM-DMARC / blocklist / scam verdict for triage | Pattern - a script on the raw message | sender-checks.md |
| Sender memory, ignore list, "never moves alone" | Pattern | learning-guardrails.md |
Pipeline at a glance
- Fetch new messages (read-only), skip senders on the ignore list.
- Mechanical check on the raw message (templates/sender-check.md).
- Three questions: who writes, what do they want, where does it go (pipeline.md).
- Urgent (< 48 h, client blocked, money waiting) → immediate alert to the chief.
- Numbered proposal list (templates/triage-report.md);
nothing new →
[SILENT]. - Apply moves only after "ok all" / "ok except n, m".
- Store each confirmed sender → category → folder.
Critical rules
- Nothing is moved, marked read or deleted without the owner's ok. No answer → nothing moves.
- When the mechanical check and the model's reading disagree, the check wins for bulk/spam/phishing verdicts.
- Phishing: never click, never reply, never load remote content.
- A reply stays in the folder of the first message so the thread stays whole.
- One mailbox per email adapter per profile - design the profiles around it (hermes-gateways).
- Triage never sends. Replies go through hermes-outbound.
Sources
- https://hermes-agent.nousresearch.com/docs/user-guide/messaging/email (adapter, authenticated sender, Himalaya skill)
- https://hermes-agent.nousresearch.com/docs/user-guide/features/cron (
every 2h,[SILENT]) - https://www.rfc-editor.org/rfc/rfc8601 (Authentication-Results header)
- https://www.rfc-editor.org/rfc/rfc2369 (List-Unsubscribe) · https://www.rfc-editor.org/rfc/rfc8058 (one-click unsubscribe)
