# Breadcrumbs: Hermes Agent plugin

> Memory and a context engine in which every line has an address.

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

Memory and a context engine in which every line has an address. Each turn, tool step and tool result is a crumb in a content-addressed, append-only store (CRC32C ids, Merkle commits). One tool, crumb(id, level), shows any memory from a one-line handle (0) to its exact bytes (1). crumb_find searches with BM25: no vectors, no model. Each recall, find, open and fold writes a record of what the model saw. With context.engine breadcrumbs, a long chat folds into a layer of crumbs with no model call, and the model opens any folded turn by its id. /island gives each codebase its own profile. A read-only explorer shows the sessions, the zoom and the context of each turn.

## Good to know before installing

Every turn, tool step and tool result is stored word for word, append-only, in $HERMES_HOME/breadcrumbs/. When config.json lists hive peers, crumb_find queries go to those peers and crumb fetches blobs from them. An optional background thread runs your local llama-completion binary on a local GGUF model after a span or session closes, with a minimal environment (BREADCRUMBS_SUMMARIZE=0 turns it off). /island, after you confirm, runs `hermes profile create --clone-from` (copying the profile's keys, plugins and memory) and `hermes config set terminal.cwd`, then ends the chat. The dashboard and log views read config.yaml and state.db of your profiles read-only, and the memory slot setup writes non-secret values to config.yaml.

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 breadcrumbs
```

2. Said no? Turn it on later:

```bash
hermes plugins enable breadcrumbs
```

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: jnorthrup (Community)
- Needs: No API keys declared
- Works on: linux, macos, windows
- Requires Hermes: `>=0.22.5`
- Version: 0.4.2
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/breadcrumbs)
- [Source code](https://github.com/breadcrumbs-agency/hermes-breadcrumb-plugin#readme)
- [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
