BrainBase Documentation

Your AI forgets everything. Give it a real brain.

$ npm install -g brainbase

Works with Claude Code · Cursor · Windsurf · Gemini · Codex · OpenClaw · Aider · any MCP client

bash
$ npm install -g brainbase    # Install globally
$ brainbase init              # Setup wizard — detects your AIs, configures everything
$ brainbase watcher start     # Start the background brain daemon
# That's it. Use your AI normally. BrainBase runs silently.

What is BrainBase?

Every AI starts from zero. Every session. Every time. You explain the same architecture three times this week — and tomorrow it asks what framework you use.

BrainBase is a real brain for every AI. Not a vector database. Not RAG. Not a markdown file you manually maintain. It's 92 neuroscience mechanisms — how the human brain stores, retrieves, connects, and strengthens memories — translated into 18,000 lines of TypeScript.

The AI you use (Claude Code, Cursor, Gemini — any of them) is just the mouth. It produces words. The brain behind it? That's BrainBase. Same personality, same memories, same knowledge — no matter which AI you talk through. Switch tools mid-project. BrainBase doesn't care. It knows you.

How it works
You talk to any AI
       |
       v
  [ BrainBase ]
       |
  +--------+--------+--------+
  |        |        |        |
Thalamus  Senses  Emotion  Memory
(filter)  (analyze)(feel)  (store)
  |        |        |        |
  +--------+--------+--------+
       |
  Knowledge Graph
  (nodes + edges + spreading activation)
       |
       v
  Context Generator
  (builds a narrative briefing for your AI)
       |
       v
  Your AI now knows you
92 mechanisms 18,000 lines 100% local source-available