Recall

From its catalog listing

Local file recall: a private on-device index of the documents already on the user's machine, with a search tool over file content (SQLite FTS5, no network and no embedding service), a recall_open reader for PDF, Word, Excel, PowerPoint, OpenDocument, Markdown, CSV, email and source files, an @recall: context reference that expands matching passages into the turn, and a pre_llm_call hook that puts up to three candidate file paths in front of the model before it answers a document question. Five tools (recall_index, recall_search, recall_open, recall_stats, recall_forget), a bounded background refresh on session start, and the /recall slash command. Extraction is standard library only (FlateDecode-aware PDF stream extractor, OOXML text nodes).

Good to know before installing

reads the contents of files under the folders the user points it at (default ~/Documents; any folder can be named, and a folder inside Hermes' own home is refused), and recall_open / @recall: read any absolute file path the model or user names outside the refused set; extracted text is stored in a plaintext SQLite index under HERMES_HOME/plugin-data/recall/, short excerpts are injected into the model prompt on turns whose message looks document-related (disable with the ambient setting, or drop paths with recall_forget), and indexed or opened text reaches the user's model provider in the normal course of a turn. Every read is checked on the RESOLVED path first: credential stores (.env, *.pem, id_rsa, .ssh, .aws, .config, auth.json, state.db and a wider built-in denylist), anything inside Hermes' home (vault, session transcripts, mcp-tokens/, webhook_subscriptions.json, dashboard session token, this plugin's own index) and virtual filesystems such as /proc are refused. Files on disk are never modified, moved or deleted; no network calls and no credentials.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install recall
  2. Said no? Turn it on later:
    hermes plugins enable recall
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Work & business
Maintained by
memeshee (Community)
Needs
No API keys declared
Adds tools
recall_index recall_search recall_open recall_stats recall_forget
Adds hooks
pre_llm_call on_session_start
Needs Hermes
0.19.0 or newer
Version
0.2.1
In the catalog
2026-11-09

Known issues (from its catalog listing)

  • Scanned PDFs and images are indexed by filename only - there is no OCR, and recall_stats reports the skip reasons.
  • Ranking is lexical (BM25 plus path, recency and phrase boosts), not semantic; no embedding model is used.
  • The first index of a large folder costs roughly 16 ms per file (measured over 3,000 files of a mixed real tree).
  • Name-based filtering cannot be complete for a password written inside an ordinary document; the Hermes-home, credential-directory and virtual-filesystem rules are enforced regardless of filename.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in work & business

All work & business plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins