Introduction
claude-db gives Claude Code a memory that lasts and a map of your code. It runs on your machine, against your own database.
Why
Every Claude Code chat starts from zero. You explain the same decisions, dead ends and rules again, and Claude works out what calls what from scratch.
claude-db keeps what you decided and a map of your code, and gives Claude the right part of it at the right time.
What it does
Remembers across chats
Decisions, dead ends and rules are saved when a chat ends. The next chat starts by seeing them.
Recalls what fits
Each prompt gets the one or two earlier memories that match it, and nothing when none fit. Capture and recall are hooks, so you never run a search.
Maps your code
Who defines or calls a symbol is answered in one call from a local graph, instead of grep and reading files.
Get started
You need Node 22.16 or newer and a git repository.
npm install -g claude-db
cd your-project
claude-db install --projectRestart Claude Code. There is nothing else to run. Continue with Installation and the Quick start.
What it is not
It is not a cloud service, and there is no account or telemetry. Memory lives in a database you choose. Two small features call Claude Haiku through your own Claude Code login, and each has an off switch. See Privacy.
It does not replace CLAUDE.md. A stable overview of your project belongs there. claude-db stores what actually happened.