Skip to content

Cerebro 0.1.0

Choose a tag to compare

@marcodavidd020 marcodavidd020 released this 29 Jun 17:12

Persistent code-knowledge memory across AI chat sessions. An MCP server that caches a codebase's structure and your understanding of it in a local SQLite "brain", so new sessions query it instead of re-reading folders — token-cheap and 100% local.

Install

claude mcp add cerebro -- uvx cerebro-code-memory

Or the full Claude Code plugin (MCP server + session hooks + cerebro-first subagents):

/plugin marketplace add marcodavidd020/cerebro-mcp
/plugin install cerebro@cerebro

Highlights

  • Structural map — tree-sitter symbols + import graph with PageRank centrality; resolves tsconfig/jsconfig aliases. Languages: Python, JS/TS (JSX/TSX), Dart/Flutter.
  • Cached summaries — 1–3 sentence English summaries per file, reused across sessions; hash-based freshness flags stale entries.
  • Decision logcerebro_note / cerebro_recall capture the why behind the code.
  • Optional local semantic search — model2vec embeddings (no torch, no API key, nothing leaves the machine); hybrid semantic + keyword to the exact path:line.
  • Architecture insights — impact (blast radius), cycles, orphans, dead symbols, and a name-resolved call graph.
  • Git-aware sync across nested repos; HTML dependency graph + Obsidian export; living-docs audit.

Privacy: no torch, no API keys, nothing leaves your machine. Requires Python ≥ 3.10.

📦 PyPI: https://pypi.org/project/cerebro-code-memory/