Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.11.0 (2026-09-15), so it may lag behind newer releases.
Search code, trace calls and dependencies, inspect architecture, and assess the impact of edits through MCP tools or a CLI.
What you can do with codebase-memory-mcp
Index a local repository and reuse its code structure across sessions.
Present at v0.0.1
Good to know
Static extraction can miss dynamic or unsupported constructs. Coverage tools report gaps; graphs larger than the memory budget fail without replacing the previous index.
Trace callers, callees and cross-file dependencies of a function.
Present at v0.0.1
Good to know
Resolution depends on the language and source patterns the analyzer recognizes.
Find functions and classes by name, file, relationship or caller count.
Present at v0.0.1
Good to know
Zero callers is a static-analysis signal; it does not establish that code is unused at runtime.
Query code relationships with read-only Cypher-style expressions.
Present at v0.0.1
Good to know
Supports a subset of Cypher; it is not a general Neo4j server.
Search text in indexed source files and retrieve source for a named function.
Indexing spills temporary work under the cache and fails whole with `over_memory_budget` if necessary, preserving the previous index; increase `CBM_MEM_BUDGET_MB` when the graph cannot fit.
Behavior changedAffects: Users indexing large repositories or setting memory budgets.
Allow one full `index_repository` run after upgrading from v0.10.8 or earlier; File identities now keep extensions. ADRs and metadata survive, then incremental indexing resumes.
Action requiredAffects: Users with indexes created before v0.11.0.
For machine parsing, request tool `--format json` or outer `--json` for the MCP envelope; default output is compact tree text with response-local path references.
Action requiredAffects: Scripts parsing default CLI or tool output.
`watcher_enabled=false` disables the watcher entirely while manual and automatic first indexing remain available; stop the daemon after changing this startup-read setting.
Uninstall continues binary/index cleanup after client-config failures and exits nonzero with the remaining failed files; explicit index deletion removes SQLite sidecars.
For native upgrades, run the adjacent `install.sh` or `install.ps1`; `update` now prints the command instead of replacing itself. npm/PyPI users update through their package manager.
Action requiredAffects: Native installs and scripts expecting `update` to perform installation.
Every release archive includes the UI; the separate UI variant is gone. `--ui` and `--standard` update flags are accepted as no-ops again from v0.10.3.
`uninstall` now removes the installed binary as well as owned client configuration; index deletion asks for confirmation and the adjacent installer is left in place.
Queries gain `EXISTS {}`, `COUNT(DISTINCT)`, label alternation and more scalar functions; unsupported syntax now raises errors instead of silently returning empty results.
Index large repositories within a memory budget while preserving the previous index if the new run cannot finish.
Details
Indexing spills finished work to disk and reports over-budget failure without replacing the serving index. The first run rebuilds old indexes once; compact output gains bounded semantic pagination, and new tools expose file outlines and snapshot comparisons.
Also: File outlines, graph comparisons, SQL/dbt lineage, broader client support and explicit output-contract changes.
v0.11.0. Allow time for one full reindex per old index; ADRs and metadata are preserved. Native binaries are available for Linux, macOS and Windows.
Behavior changed: Index a local repository and reuse its code structu…Action required: Index a local repository and reuse its code structu…Action required: Run code exploration tools directly from the comman…Behavior changed: Run code exploration tools directly from the comman…Behavior changed: Find functions and classes by name, file, relations…Action required / inferred: Find code using semantic keywords or full-text rank…Added: List declarations in source order for one exact rep…Added: Compare added and removed node and edge identities…Added: Trace table, view and dbt model dependencies throug…Behavior changed: Save and retrieve architecture decisions across cod…Behavior changed: Refresh the code graph automatically as indexed fil…Now works: Index and explore code on Windows.Now works: Share background indexing, watchers and the graph U…Now works: Register the code exploration tools with supported…Behavior changed: Register the code exploration tools with supported…Now works: Share background indexing, watchers and the graph U…Behavior changed: Index a local repository and reuse its code structu…Now works: Index a local repository and reuse its code structu…Behavior changed: Find code using semantic keywords or full-text rank…Behavior changed: Query code relationships with read-only Cypher-styl…Now works: Build and run local code exploration on BSD systems.Behavior changed: Register the code exploration tools with supported…Now works: Register the code exploration tools with supported…Now works: Trace callers, callees and cross-file dependencies…Now works: Search text in indexed source files and retrieve so…Now works: Inspect which files and source ranges were skipped…Now works: Bootstrap a teammate's local graph from a compresse…Now works: Explore a repository's code relationships in an int…Behavior changed / inferred: Inspect languages, packages, routes, entry points a…
v0.10.8 with v0.10.0, v0.10.1, v0.10.2, v0.10.3, v0.10.4, v0.10.5, v0.10.6
Check which files and code ranges are missing from your index.
Details
`check_index_coverage` and the UI expose missed code; clients share a coordination daemon. The grouped fixes restore MCP output, concurrent indexing, legacy upgrades and configuration repair after the initial 0.10.0 release.
Also: Coordinated sessions, repaired MCP replies and installers, and explicit upgrade and query-output changes.
Use v0.10.8 for this series. v0.10.0 MCP replies were broken; 0.10.7 npm/PyPI packages were deprecated or yanked because their binary URLs were wrong.
Added / inferred: Inspect which files and source ranges were skipped…Added: Share background indexing, watchers and the graph U…Added: Distinguish callable references from actual calls a…Added: Choose which detected coding clients receive tool c…Action required: Query code relationships with read-only Cypher-styl…Action required: Share background indexing, watchers and the graph U…Action required: Register the code exploration tools with supported…Behavior changed: Register the code exploration tools with supported…Behavior changed: Explore a repository's code relationships in an int…Behavior changed: Run code exploration tools directly from the comman…Now works: Register the code exploration tools with supported…Behavior changedBehavior changed: Register the code exploration tools with supported…Now works: Register the code exploration tools with supported…Now works: Index and explore code on Windows.Now works: Share background indexing, watchers and the graph U…Now works: Index a local repository and reuse its code structu…Now works: Index a local repository and reuse its code structu…Now works: Query code relationships with read-only Cypher-styl…Now works: Trace callers, callees and cross-file dependencies…Now works: Explore dependency relationships across multiple in…Now works: Inspect which files and source ranges were skipped…Now works: Search text in indexed source files and retrieve so…Behavior changed: Index a local repository and reuse its code structu…Behavior changed: Run code exploration tools directly from the comman…Now works: Build and run local code exploration on BSD systems.Now works: Register the code exploration tools with supported…Behavior changed: Register the code exploration tools with supported…Now works: Register the code exploration tools with supported…Behavior changed: Trace callers, callees and cross-file dependencies…Action required: Register the code exploration tools with supported…Behavior changed: Register the code exploration tools with supported…
Finish indexing a repository even when an individual source file crashes or hangs the analyzer.
Details
A supervisor quarantines failing files and reports them in `skipped[]` and a log. The UI adds source previews and dead-code filtering, while CLI tools accept flags, stdin and `--args-file`.
Also: Windows ARM64, richer graph navigation, script-friendly CLI arguments and session watcher controls.
v0.9.0, including native Windows ARM64 binaries. Partial indexes expose skipped files; extraction remains static analysis.
Now works: Index a local repository and reuse its code structu…Behavior changed: Index a local repository and reuse its code structu…Now works: Save and retrieve architecture decisions across cod…Added: Run code indexing and exploration natively on Windo…Now works: Index and explore code on Windows.Behavior changed: Explore a repository's code relationships in an int…Behavior changed: Run code exploration tools directly from the comman…Now works: Trace callers, callees and cross-file dependencies…Now works: Query code relationships with read-only Cypher-styl…Behavior changed: Refresh the code graph automatically as indexed fil…Now works: Search text in indexed source files and retrieve so…Now works: Discover HTTP routes and possible calls between ser…
Find code by meaning as well as by names and literal text.
Details
The 0.6–0.8 release pages, published together on June 12, add semantic and BM25 search, graph artifacts, cross-repository relationships and expanded query syntax. v0.8.1 removes Nim parsing.
Also: Shared graph snapshots, cross-repository links, more language coverage and type-aware call resolution.
v0.8.1; older 0.6.0–0.8.0 release pages are archived without binaries. Native and portable Linux distributions are documented, alongside npm and PyPI installation.
Added: Find code using semantic keywords or full-text rank…Added: Find structurally similar functions and semantic re…Added: Bootstrap a teammate's local graph from a compresse…Added: Explore dependency relationships across multiple in…Added / inferred: Inspect argument-to-parameter data flow and publish…Added / inferred: Find functions with high complexity, deep loops or…Added: Build and run local code exploration on BSD systems.Behavior changed: Index a local repository and reuse its code structu…Action required: Index a local repository and reuse its code structu…Behavior changed: Trace callers, callees and cross-file dependencies…Behavior changed: Index a local repository and reuse its code structu…Now works: Find functions and classes by name, file, relations…Behavior changed: Find functions and classes by name, file, relations…Now works: Map staged, unstaged or branch changes to affected…Now works: Inspect languages, packages, routes, entry points a…Behavior changed: Inspect languages, packages, routes, entry points a…Behavior changed: Query code relationships with read-only Cypher-styl…Behavior changed: Search text in indexed source files and retrieve so…Now works: Index and explore code on Windows.Now works: Index a local repository and reuse its code structu…Behavior changed: Index a local repository and reuse its code structu…Now works: Index a local repository and reuse its code structu…Behavior changed: Explore Kubernetes resources and Kustomize overlay…Behavior changed: Discover HTTP routes and possible calls between ser…Behavior changed: Register the code exploration tools with supported…Behavior changed / inferred: Trace callers, callees and cross-file dependencies…Behavior changed: Bootstrap a teammate's local graph from a compresse…
v0.5.7 with v0.5.0, v0.5.1, v0.5.2, v0.5.3, v0.5.5, v0.5.6
Explore your code graph in a local interactive 3D view.
Details
The UI variant adds `--ui=true`; `auto_index` indexes a detected session root. `search_code` gains compact, full and file-list modes, and `.codebase-memory.json` supports extension mappings.
Through v0.5.7; choose the UI binary for visualization at localhost:9749. Source builds use C/C++ compilers and zlib instead of Go.
Added: Explore a repository's code relationships in an int…Added: Index a newly opened project automatically when an…Added: Explore Kubernetes resources and Kustomize overlay…Added: Choose which language parser handles a custom file…Action requiredBehavior changed: Index a local repository and reuse its code structu…Now works: Register the code exploration tools with supported…Behavior changed: Register the code exploration tools with supported…Behavior changed: Search text in indexed source files and retrieve so…Now works: Index a local repository and reuse its code structu…Now works: Map staged, unstaged or branch changes to affected…Now works: Index and explore code on Windows.Now works: Trace callers, callees and cross-file dependencies…Behavior changed: Refresh the code graph automatically as indexed fil…
Map your Git changes to affected symbols and callers.
Details
The grouped releases add `detect_changes`, `get_architecture`, `manage_adr`, a CLI and automatic reindexing. They also change search and watcher defaults and remove the file-reading and directory-listing tools.
Also: Architecture summaries, persistent decisions, CLI access, Windows support and broader language coverage.
Through v0.4.10. Git is required for change analysis; Go source builds now require Go 1.26 and a C compiler.
Added: Map staged, unstaged or branch changes to affected…Added: Inspect languages, packages, routes, entry points a…Added: Save and retrieve architecture decisions across cod…Added: Run code exploration tools directly from the comman…Added: Refresh the code graph automatically as indexed fil…Added: Register the code exploration tools with supported…Added: Index and explore code on Windows.Behavior changed: Index a local repository and reuse its code structu…Now works: Trace callers, callees and cross-file dependencies…Behavior changed: Find functions and classes by name, file, relations…Removed: Read files and list directories through MCP tools.Behavior changed: Index a local repository and reuse its code structu…Now works: Query code relationships with read-only Cypher-styl…Behavior changed: Refresh the code graph automatically as indexed fil…Behavior changed: Index a local repository and reuse its code structu…Action required / inferredNow works: Index a local repository and reuse its code structu…Action required: Register the code exploration tools with supported…
Trace callers and dependencies in a persistent local index of your code.
Details
The initial tagged version indexes source into a local graph and exposes structural search, call tracing, source snippets and read-only Cypher queries through MCP.
v0.0.1 baseline before the first listed GitHub release. Source builds require Go 1.23+, a C compiler and Git; Windows users use WSL2.
Added: Index a local repository and reuse its code structu…Added: Trace callers, callees and cross-file dependencies…Added / inferred: Find functions and classes by name, file, relations…Added: Query code relationships with read-only Cypher-styl…Added: Search text in indexed source files and retrieve so…Added / inferred: Discover HTTP routes and possible calls between ser…Added: Read files and list directories through MCP tools.
Are you @DeusData?Claim it, and your coding agent keeps it current with each release
