Open source · MIT OR Apache-2.0

One Brain.
Any Tool.

Portable, git-tracked AI memory that compounds across every tool you use. Works with Claude Code, Cursor, Antigravity, and more.

bash
$ curl -fsSL https://get.cerebrumma.com | sh

How it works

Intelligence that compounds

01

Install & init

One command installs the CLI, MCP server, and wires up Claude Code. Run cerebrum init to create your Brain.

02

Memory auto-captures

The git hook records every commit. The file watcher captures every save. Your Brain grows without thinking.

03

Dream cycle compounds

The dream cycle distills episodes into skills and facts — paste into any LLM, or let the daemon do it automatically.

cerebrum map --graph

See your Brain think.

Every memory is a node. Every connection is inferred from meaning — not manual links. One command renders your whole Brain as an interactive 3D neural map, right in your browser.

Episodic
Semantic
Procedural
Personal
Reflection
.cerebrum/neural_map.html
Initializing neural map…

drag a node · scroll to zoom · hover to inspect · search to filter

Open fullscreen

Runs fully offline — the generated HTML is self-contained. This live demo shows a sample Brain; yours renders from your own memories.

Built for developers

Everything your Brain needs

Git-tracked memory

MCP-native injection

5-layer architecture

3D neural map

Global + local Brain

Dream cycle

Semantic search

No lock-in

Memory format

Human-readable,
git-native.

Every memory entry is a Markdown file with YAML frontmatter. No proprietary format. No binary blobs. Diff it, grep it, share it.

markdown
---
timestamp: 2026-05-08T18:00:00Z
source_tool: cli
salience_score: 0.6
bias_flag: false
provenance: manual
---

Always prefer functional components in React.

CLI reference

Commands

cerebrum initCreate .cerebrum/ in current project (--global for ~/.cerebrum/)
cerebrum add "..."Add an episodic memory entry (--global for the global Brain)
cerebrum statusShow entry counts across memory layers
cerebrum search <query>Semantic search across every memory layer
cerebrum why <query>Trace the origin of a rule or insight
cerebrum map --graphRender the interactive 3D neural map
cerebrum hook installInstall the git post-commit hook
cerebrum watchWatch for file saves and auto-capture
cerebrum dreamArchive episodes + generate a reflection prompt
cerebrum dream --autoRun the full dream cycle with a configured LLM key
cerebrum daemon startRun the watcher + dreamer as background intelligence
cerebrum config set gemini_key <key>Configure a key to enable auto-reflection
cerebrum briefGet a 'state of the union' briefing on your Brain
cerebrum statsView Brain health and usage statistics
cerebrum auditAudit the project and seed the Brain from it

FAQ

The honest answers

Including the one everybody asks first.

I already keep my rules and specs in Markdown. Why do I need this?

Fair — if you live in one tool and keep disciplined rules files, you already have a lot of this. Three things a specs/folder doesn't do:

  1. Nobody has to write the files.The git hook and file watcher capture what actually happened — decisions, commits, what you tried and abandoned. Hand-maintained docs drift the moment you get busy. Auto-captured memory doesn't.
  2. Retrieval, not injection.A docs folder grows forever and you can't paste all of it into context. Cerebrumma embeds every memory and surfaces only what's semantically relevant to the task at hand — which matters exactly when the project gets big enough that “include everything” stops working.
  3. It distills.The dream cycle compresses raw episodic logs into lasting rules and facts, promoting them into deeper memory layers. That's the part nobody does by hand.
Can't Claude or Cursor just read my .cursor/ or specs/ folder?

Yes — and they will, if you point them there. The problem isn't reading, it's knowing which slice matters right now, and keeping it current. Every tool also has its own convention (.cursor/rules, CLAUDE.md, …) and none of them share. Cerebrumma serves the relevant memory over MCP, so it's the same Brain whichever tool asks.

Does my code or data leave my machine?

No. Cerebrumma runs entirely locally by default. Embeddings are computed on-device, and every memory is a plain Markdown file inside your project. No keys, no cloud, no telemetry. The only time anything leaves your machine is if you opt in to automatic reflection (dream --auto) — and you supply that key.

Do I need an API key?

No. Everything core — capture, search, the neural map, the manual dream cycle — works fully offline. A key only enables the automatic dream cycle. Without one, you run the reflection through any LLM you already pay for.

Will the background daemon run up my API bill?

No. Auto-reflection is frequency-capped by design: it only runs once enough new episodic memory has accumulated, and it enforces a cooldown between runs. It can't spam your provider in the background.

Will it bloat my repo?

No. Memories are small plain-Markdown files with YAML frontmatter. The embedding model is cached once, globally, in ~/.cerebrum/models — never inside your project.

What exactly is the “dream cycle”?

It reads your raw episodic memory (commits, sessions, saves) and distills it into lasting knowledge — facts, skills, and preferences — promoting each into the right memory layer. Run it by hand with any LLM, or let the daemon do it in the background. It never deletes anything automatically; prune suggestions are always left for you to review.

Which tools does it work with?

Anything that speaks MCP — Claude Code, Cursor, Antigravity, Windsurf, and more — plus the cerebrumCLI itself. Your Brain isn't tied to any one of them.

How is this different from Obsidian or a notes app?

Those store notes you write and link by hand. Cerebrumma captures what you actually did, automatically, and serves it to your AI. There's no manual linking — connections are inferred from meaning. It complements a notes app; it doesn't replace one.

Is there any lock-in?

None. Every memory is a plain Markdown file with YAML frontmatter, sitting in your repo under version control. Delete Cerebrumma tomorrow and your Brain is still perfectly readable. Open source under MIT OR Apache-2.0.

Still have a question? Open an issue on GitHub.

Ready to build your Brain?

One command. Runs locally by default. Your Brain, no lock-in.

bash
$ curl -fsSL https://get.cerebrumma.com | sh