Main

For best results, treat memory as a product surface:

• Decide what should be written (decisions, preferences, constraints) and what should not (raw logs, secrets).
• Periodically compact and summarize cold memory nodes so search stays fast and relevant.
• Use delta-based sync (cursor hashes) to keep the agent “caught up” without large token spends.

README excerpt (verbatim)

remindb

Agentic memory in a single SQLite file.
Stop letting your agent re-read the same notes every session.

Why I built this

Coding agents already have memory. CLAUDE.md, AGENTS.md, your notes folder, that growing pile of project READMEs. Stuff persists just fine.

The problem is how the agent consumes it. Every session starts by re-reading the whole pile from scratch — every Read, every Grep, scanning raw prose the agent has already processed dozens of times. Big context windows don't fix it. A 1M-token window is still paid per call, and still can't tell yesterday's stale note from today's relevant one.

Raw markdown is the wrong shape for memory. Not because it can't hold the words — it can — but because it forces the agent to pay full freight on every read.

remindb is a single SQLite file your agent treats as long-term memory. It parses your notes (Markdown, HTML, JSON, YAML, TOON) into a structured tree, hashes every node, encodes repetitive structures compactly when it saves tokens, and surfaces the whole thing through a tight MCP tool suite.

What you get

A tree the agent can index, not skim. Instead of ls-ing a folder and reading every file to orient, the agent calls MemoryTree once. Each entry is a typed node — [heading], [list], [kv], [table], [preamble], [text], [code], [embed] — with an ID, a short label, a temperature, and a token count. Think of it as ls -la for memory: one call, a scannable index, hot stuff floats up.

A real slice (from remindb inspect --tree):

[preamble] Preamble: framework, language, project (id=3kGXxidmWBp file=CLAUDE.md temp=0.50 tok=14)

### FAQ

**Q: Is remindb a server?**
A: README frames it as one portable SQLite file with an MCP runtime for fast queries.

**Q: How do I install it quickly?**
A: Use the provided install script for your OS, then verify with `remindb --version`.

**Q: Can I share memory across agents?**
A: Because it’s one `.db` file, you can copy/sync it, but you still need to manage access and privacy.