Open source · MIT · works with Claude Code, Desktop & Hermes

Don't summarize your memory.
Search it.

brethof-mind gives Claude Code a memory that survives every session — the complete history of what you did, kept on your own machine and searchable by full-text, vector, and graph. No cloud, no API, no summaries to trust.

MIT licence · 100% local · built on SurrealDB · full-text + vector + graph

🔒 100% local
🔍 Full-text + vector + graph
No API keys
📝 Notes + full archive
🧮 Claude Code, Desktop & Hermes

Summaries are lossy. Your memory shouldn't be.

Claude Code's context gets compacted and truncated — and a summary is just one model's guess at what mattered. brethof-mind doesn't summarize. It keeps the complete transcript of every session and makes it searchable, so recall never depends on what survived a summary or fit in a context window.

Two memories, working together

brethof-mind keeps two stores, and the pairing is the point.

📝

Curated memory

What the agent writes down on purpose — decisions, architecture, status, your corrections. Dense and high-signal. Your notes.

💾

Full chat memory

Every transcript line, captured automatically. Complete and raw. The recording.

🛡️

Notes, with a safety net

Notes are fast but lossy; the recording is the insurance. When the notes missed something, the full history still has it — searchable. Speed of a summary, without ever depending on one.

Your tools, one memory

The memory tools run in any MCP client. Automatic capture & recall come from Claude Code — and Claude Desktop runs Claude Code as its engine, so you get the full experience in both.

  • Claude Code — full: tools + automatic capture & recall hooks
  • Claude Desktop — full: runs on Claude Code same hooks + tools
  • OpenClaw coming soon
  • Hermes — full: drop-in memory provider plugin plugin

Any other MCP client can use the memory tools too — the automatic capture is the Claude Code (and Desktop) piece.

Up and running in a few minutes

Docker + Python + Claude Code. Full walkthrough in the README.

# 1. clone + configure git clone https://github.com/BrethofAI/brethof-mind.git cd brethof-mind && cp projects.example.json projects.json # 2. start SurrealDB docker compose up -d # 3. install the MCP server + create the schema python -m venv mcp-server/.venv mcp-server/.venv/bin/pip install -r mcp-server/requirements.txt mcp-server/.venv/bin/python mcp-server/scripts/init_db.py # 4. register with Claude Code, then install the hooks claude mcp add memory -- "$(pwd)/mcp-server/.venv/bin/python" "$(pwd)/mcp-server/server.py" cp hooks/*.py ~/.claude/hooks/

Read the full README

brethof-mind is free. Our flagship pays the bills.

We build local-first tools. Brethof Voice Pro is the paid one: private speech-to-text and translation that runs entirely on your machine — 30 languages of transcription, 38 of translation, a voice keyboard, and its own MCP server. No cloud, no subscription.

Meet Brethof Voice Pro →

🎤

Brethof Voice Pro

Local speech-to-text + translation. 14-day free trial, perpetual licence.

See the page →

Everything we build

External:   YouTube · GitHub