hermes-cashew
magnus919/hermes-cashew
Hermes Agent memory provider plugin backed by a local Cashew thought graph with semantic search
hermes-cashew is a Hermes Agent memory provider plugin that stores conversation context in a local Cashew thought graph, with semantic search and automatic context recall.
What hermes-cashew does
hermes-cashew stores conversation context in a local Cashew thought graph and recalls it automatically. On first load it generates cashew.json with defaults, it can use an explicit Hermes auxiliary.memory mapping for LLM-powered extraction, it adds forest-level insight extraction through on_pre_compress, and it runs graph consolidation on a persistent Hermes cron schedule.
An integrity audit inspects existing profiles without opening a writable database. Running python -m plugins.memory.cashew.integrity on a brain.db file reports schema and provider fingerprints, embedding validity, vector-index parity, orphan rows, referential graph defects and permanence contradictions. Large scans use fixed row, byte and deadline budgets, and a cutoff is reported as audit_incomplete. Repairs are opt-in with --apply --confirm: the command takes an exclusive maintenance lease, writes and verifies a SQLite backup, runs bounded repairs inside a transaction and rolls back on failure while keeping the backup.
Key features
- Local Cashew thought graph with semantic search and automatic recall
- cashew.json generated with defaults on first load
- Optional auxiliary.memory mapping for LLM-powered extraction
- Insight extraction through on_pre_compress
- Graph consolidation on a persistent Hermes cron schedule
- Read-only integrity audit and opt-in backup-backed repair
When to use it
- Giving Hermes a graph-based long-term memory stored on your own machine
- Auditing a Cashew brain.db for orphan rows and broken references
- Repairing a memory database with a verified backup taken first
Who it is for: Hermes Agent users who want graph-structured local memory and tools to check its health.
How it fits with Hermes Agent
A Hermes memory provider plugin that connects Hermes to the Cashew memory project and uses Hermes cron for consolidation.
Requirements: Hermes Agent, cashew-brain from the reviewed upstream source commit named in the README, SQLite 3.35 or newer, and sqlite-vec for vector similarity search
FAQ
What is hermes-cashew?
hermes-cashew is a memory provider plugin for Hermes Agent. It stores conversation context in a local Cashew thought graph and recalls it with semantic search.
Does hermes-cashew work with Hermes Agent?
Yes. It is built as a Hermes memory provider plugin and uses Hermes features such as auxiliary.memory, on_pre_compress and cron scheduling.
What do I need to run hermes-cashew?
You need Hermes Agent, cashew-brain from the upstream commit named in the README, SQLite 3.35 or newer and sqlite-vec for vector search.
Similar memory for Hermes Agent
All memoryZero-token Rust agent memory with a Hermes Agent memory provider plugin
PCIRCLE-AI MeMeshLocal SQLite memory and messaging layer for coding agents, with a native Hermes Agent memory provider
amrlazw Hermes Fleet MemoryShared vector memory for Hermes agent fleets with on-demand MCP retrieval and work/personal firewalls
Ex8-ca memex8Self-hosted memory system with per-type decay and intent-weighted search, plus a Hermes memory plugin
rarf OptMem for HermesLocal Hermes memory provider with append-only records, decay-compressed summaries and BM25 search
sagarbehere Working Memory SystemPersonal second brain on Hermes Agent: capture thoughts in chat, get them filed, retrieved and reminded
Related guides: SOUL.md for Hermes Agent: what it is and how to write one · Run multiple Hermes agents with profiles