Agent Memory
Plugin
claude-db
Free, open-source memory for Claude Code. Your own database, no cloud, no subscription.
Plugin Signal70/100Solid
maintained97
capable29
documented100
adopted50
Install
$ npx -y skills add Avijit07x/claude-db --agent claude-code
Stats
234
Stars
27
Forks
Active
Maintenance
TypeScript
Language
Apache-2.0
License
9d ago
Last commit
2mo ago
Created
2h ago
Added
What's inside
Skill(3 skills)
/catchupAnswer "where did I stop?" for this project. Gives three short groups, done, open and next, taken from the last chat, the recorded to-dos, the last handoff note and git. Use when the user comes back to a project, starts a new chat, or asks where they left off. It writes nothing./cdb-scanMap this codebase into project memory — a code graph of every symbol and how they connect, plus a written profile of stack, layout, conventions and workflows. Re-run any time to refresh both in place. Use when memory is newly installed on an existing project, or when the project/handoffWrite a short handoff note for the next chat or a teammate, with what is done, what is open, what comes next and what was rejected and why. Saves it to project memory so the next chat sees it at the start, and prints it so it can be pasted into a message or a pull request. Use
README
Free, open-source memory for Claude Code. Your own database, no cloud, no subscription.
Documentation · Quick start · CLI reference
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 fixes that. It 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, and 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.
- Maps your code. Who defines, calls or imports a symbol is answered in one call, instead of grep and reading files. It follows imports in TypeScript, JavaScript, Python, Go, Rust, Java and Kotlin.
- Keeps it yours. SQLite on your machine by default, or Postgres or MongoDB to share across machines. No cloud, no subscription.
Install
You need Node 22.16 or newer and a git repository.
npm install -g claude-db
cd your-project
claude-db install --project
Restart Claude Code. There is nothing else to run, because capture and recall are hooks.
Then load what already exists with claude-db flush and claude-db scan. The
setup guide has the rest.
Everyday use
| Where | What it does |
|---|---|
/catchup | Answers "where did I stop?" when you come back |
/handoff | Leaves a short note for the next chat or a mate |
/cdb-scan | Maps an existing codebase into memory |
claude-db status | Shows whether it is wired up and what it recorded |
claude-db doctor | Checks the setup, and finds what is wrong |
claude-db use <url> | Switches to Postgres or MongoDB (pg/mongodb) |
cdb is a shorter alias. Every command is in the
CLI reference.
Privacy
Memory stays in your own database. Two features call Claude Haiku through your
own login, and each has an off switch: claude-db distill off for making facts
from finished chats, and claude-db pick off for choosing memory per prompt.
Once a day it asks npm for the latest version ("updates": "off" stops that).
.env, secrets/, node_modules and .git/ are never stored. Text inside
<private>...</private> is stripped, and API keys and tokens are redacted
before anything is written or sent.
Documentation
- Setup guide: install, head start and habits
- Documentation site: CLI, MCP tools, databases and troubleshooting
- With and without and benchmarks: the numbers, including where plain grep wins
- Changelog
Contributing
npm install
npm run build
npm test
npm run lint
CONTRIBUTING.md has the setup, the rules and the pull request checklist, with links to adding a language and to releasing. Security reports go through SECURITY.md, privately.
License
Apache-2.0
File tree
FAQ
claude-db is a Claude Code plugin with 3 hand-picked skills, indexed on Flowy in the Agent Memory category. Install it with the command on its page. It includes catchup, cdb-scan, handoff. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is claude-db?
- Free, open-source memory for Claude Code. Your own database, no cloud, no subscription.
- How do I install claude-db?
- Run these in Claude Code: npx -y skills add Avijit07x/claude-db --agent claude-code. Then prompt normally.
- Does claude-db auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is claude-db free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it