# ELM: Hermes Agent plugin

> Local, reviewable long-term memory. You save notes (or approve notes the model proposes) and matching notes are recalled automatically.

Canonical: https://hermeswatcher.com/plugins/elm  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/elm  
Last updated in catalog: 2026-11-17

Local, reviewable long-term memory. You save notes (or approve notes the model proposes) and matching notes are recalled automatically. Off until the owner turns it on from a terminal: for all Desktop/TUI/CLI chats at once (`hermes elm auto on`, notes shared across chats; any chat can opt out with `/elm private`) or per chat (`hermes elm grant`). The model can never turn it on. Works as a general plugin or in the memory slot (`memory.provider: elm`, with the recall indicator; `hermes memory setup elm` offers auto mode). Optional memory-aware delegation backend (`delegation.backend: elm`): you name agents (models or profiles) and ELM routes subagent tasks to the one that did best on similar earlier tasks.

## Good to know before installing

No network calls, dependencies, telemetry, self-updater or background daemon of its own. Data stays in the profile's plugin-data/elm SQLite file. Recalled notes are added to the current message and so reach your model provider; in auto mode notes saved in one chat are recalled in your other chats (never in messaging, cron, subagent or ACP chats). Two optional, per-chat opt-in features make model calls through Hermes's auxiliary model slots: a search planner (query text only) and an organizer (selected captured text). Opt-in capture stores finished turns as plain text locally. Routing stores agent names, up to 12 plain-word goal keywords, success and duration (no task or result text), only for chats with ELM on, scoped like notes. Deleting a chat deletes its chat-only notes, captures and routing history (shared notes stay). `hermes elm sessions` reads the profile's session list to help pick a chat ID.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install elm
```

2. Said no? Turn it on later:

```bash
hermes plugins enable elm
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Memory & notes, Chat apps & voice
- Maintained by: Miawd3 (Community)
- Needs: No API keys declared
- Adds tools: `elm_memory`
- Requires Hermes: `>=0.23.1`
- Version: 0.4.0-preview
- In the catalog since: 2026-11-17

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/elm)
- [Source code](https://github.com/Miawd3/ELM-Hermes-plugin/blob/f62fc2952e25208e8e6b22adfb98647caaa48818/stock-plugin/README.md)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
