DeusData/codebase-memory-mcp
codebase-memory-mcp
High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.
GitHub metrics
- Stars
- 46K
- +714 this week
- Forks
- 3.8K
- 30-day growth
- —
- Open issues
- 475
| Day | GitHub stars |
|---|---|
| 2026-10-04 | 45748 |
| 2026-10-10 | 46272 |
| 2026-10-13 | 46462 |
What it does
codebase-memory-mcp is an MCP server, written in C, that parses a code repository into a knowledge graph so an AI coding agent can ask structural questions (what calls this function, which HTTP routes exist, what a change affects) instead of reading files one by one.
It ships as one native executable for macOS, Linux and Windows. Parsing uses tree-sitter grammars compiled into the binary, and the README lists 162 languages. A hybrid LSP layer adds type resolution for a smaller set, including Python, TypeScript, Go, Java and Rust. Agents reach the graph through 17 MCP tools covering search, call tracing, architecture overviews, change detection, Cypher queries and architecture decision records. A 3D graph viewer is built into the binary and opens at localhost:9749.
The installer finds supported agents on your machine and writes their MCP configuration; the README counts 45 client surfaces, among them Claude Code, Codex, Gemini CLI, Cursor and Windsurf. The authors describe the design in an arXiv preprint and report 83% answer quality with 10 times fewer tokens than file-by-file exploration across 31 repositories. Indexing and queries run locally without an API key.
Why it matters
Coding agents usually explore a repository with grep and file reads, which burns tokens and tool calls. This project indexes the code once into a graph and answers structural questions from it. The README's own example puts five such queries at about 3,400 tokens against roughly 412,000 by reading files. It is a single local binary, so there is no language runtime, Docker container or hosted service to set up.
Main features
- Indexes code into a persistent knowledge graph of functions, classes, calls and routes
- Tree-sitter parsing for 162 languages, per the README
- Hybrid LSP type resolution for a dozen languages, including Python, TypeScript and Go
- 17 MCP tools for search, tracing, impact analysis and Cypher queries
- Built-in 3D graph viewer at localhost:9749
- Indexes Dockerfiles, Kubernetes manifests and Kustomize overlays
- Installer auto-configures detected agents; `--skip-config` installs the binary only
Who it's for
- Developers using MCP-capable coding agents such as Claude Code, Codex, Cursor or Gemini CLI on large codebases
- Teams with multi-service or polyglot repositories who want call chains and cross-service links in one graph
- People who want code indexing that stays on their own machine
Strengths
- Single native binary with no runtime dependencies
- Processing stays local; the README says code never leaves your machine
- Wide language coverage through compiled-in tree-sitter grammars
- Releases are scanned on VirusTotal and the scan results are linked from release notes
Limitations
- Microsoft Defender may flag the binary as Trojan:Script/Wacatac.B!ml; the project calls this a false positive
- Semantic type resolution covers only a subset of languages; the rest get syntax-level parsing
- Some client surfaces need manual configuration
- The installer writes to your agent configuration files, and speed and token figures are the project's own measurements
Getting started
On macOS and Linux a one-line script downloads the binary and configures detected agents. Windows uses a PowerShell installer script that the README suggests inspecting before you run it.
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
Requirements: macOS (arm64 or amd64), Linux (arm64 or amd64) or Windows (amd64) and an MCP-capable agent; no language runtime, Docker or API key.
Always follow the official instructions in the README on GitHub. This overview is our summary, not a copy.
Sources
- DeusData/codebase-memory-mcpRepositoryPrimarygithub.com
- codebase-memory-mcp — Code Intelligence Knowledge Graph for AI Coding AgentsOfficial sitePrimarydeusdata.github.io
Alternatives to codebase-memory-mcp
Headroom is a Python and TypeScript tool that shrinks the text an AI agent sends to a model (tool output, logs, files, RAG chunks and chat history) so each request uses fewer tokens. The compression runs on your own machine. You can use it in four ways: a compress() library for Python and TypeScript, a local proxy you point an app at, a headroom wrap command that starts coding agents such as Claude Code, Codex or Aider through that proxy, or an MCP server. A router looks at each piece of content and picks a compressor: one for JSON, one for source code, and a small Hugging Face model called Kompress-v2-base for prose. Originals stay in a local cache, and the model can call a retrieve tool when the short version is not enough. The project publishes its own offline benchmark of four MCP-style scenarios, with savings from 21% to 57%. The README also describes steering the model toward shorter replies and labels that saving as an estimate. The latest release is v0.39.1, from September 2026.
- Stars
- 75K
- Language
- Python
- License
- Apache-2.0
- Momentum
- +1.1% 7dEstablished
Caveman is a skill plus a local proxy that reduce the tokens a coding agent spends, both in what it writes back and in what it reads. The skill changes the reply style: answer first, one idea per sentence, no greeting or recap. Code, commands, file paths, error messages and numbers are kept character for character, and your own prompts are never rewritten. There are three levels (/caveman, /ultracave and /megacave, the last one in classical Chinese) and extra commands for one-line commit messages, terse code review and shrinking memory files such as CLAUDE.md. The second part is the caveman CLI, which runs on your machine and compresses bulky input before the agent sees it: logs, CSV, YAML, JSON and test output. Originals stay on disk so the agent can pull them back. The CLI also has caveman browse for compact web pages and caveman learn, which ranks where tokens went in past sessions. Separate TypeScript and Python middleware packages apply the same compression to agents built on the Vercel AI SDK, LangChain, OpenAI or Anthropic calls. The project's own benchmark reports 33.2% fewer input tokens over 54 Claude Code runs, with 18 of 18 answers correct. The same table shows HTML sessions getting 9.9% worse, because HTML has no compressor yet.
- Stars
- 111K
- Language
- Go
- License
- Apache-2.0
- Momentum
- +1.6% 7dEstablished
OmO (the repository is oh-my-openagent) is a terminal agent for coding and other work, started with a single omo command. It runs on senpi, the author's fork of the pi coding agent, with extra features built in. You open a project, run omo and describe the job. Adding the keyword ultrawork (or ulw) to a prompt tells the agent to read the codebase first, plan, check each step and verify the result before it stops. Typing mass ulw splits a large job into a graph of agents that run in parallel, each on a model picked for its part. A memory feature called Kibitzer keeps notes as markdown files in a git repository and has a cheaper model warn the main agent before it repeats an earlier mistake. The /login command signs in with Claude, ChatGPT, Kimi and GLM subscriptions. OmO installs as a native binary through a shell script (PowerShell on Windows) or as the omo-ai package from npm or Bun. People on the older OpenCode edition can carry their settings over with omo setup. GitHub lists the licence as "Other"; the repository's LICENSE.md is the Sustainable Use License.
- Stars
- 70K
- Language
- TypeScript
- Momentum
- +0.3% 7dEstablished
RTK (Rust Token Killer) is a command-line proxy that trims the terminal output of common developer commands before an AI coding agent reads it, so less of the agent's context fills up with noise. It ships as one Rust binary. When an agent runs something like git status, a hook installed by rtk init swaps it for rtk git status, which returns a compact version: failing tests only, grouped lint errors, one-line git confirmations, shortened directory trees. The README lists filters for git, the GitHub CLI, test runners such as pytest, Jest and cargo test, linters, package managers, Docker, kubectl, AWS and Pulumi, and claims more than 100 supported commands with under 10 ms of added time. When a command fails, RTK keeps the full unfiltered output so the agent can fetch it with rtk recall instead of running the command again. The project is careful about its own numbers. It says it cuts up to 90% of the bash output an agent reads, and states plainly that this does not mean a 90% smaller bill, since shell output is only part of the input tokens. Token counts in rtk gain are estimated as bytes divided by four because RTK has no tokenizer.
- Stars
- 83K
- Language
- Rust
- License
- Apache-2.0
- Momentum
- +1.0% 7dEstablished
Understand Anything turns a codebase or supported knowledge base into an interactive knowledge graph for exploring files, functions, classes, dependencies, and relationships. Its code analysis combines Tree-sitter structural parsing with LLM-generated summaries, tags, architectural layers, tours, and business-domain information. The dashboard lets you search the graph, inspect nodes, follow relationships, and view code organized by architectural layer. The main /understand workflow creates .ua/knowledge-graph.json, with older projects continuing to use .understand-anything/. Later runs are incremental by default and re-analyze changed files. Separate commands cover change-impact analysis, explanations of specific code, onboarding guides, domain graphs, and Karpathy-pattern wiki analysis. The project supports Claude Code and a range of other coding agents and IDE integrations. Generated graph data can be committed to a repository and opened by teammates with the standalone viewer. That viewer needs Node.js 18 or newer and reads the graph from local disk without LLM calls. Building or running the analysis code from source requires Node.js 22 or newer and pnpm 10 or newer.
- Stars
- 86K
- Language
- TypeScript
- License
- MIT
- Momentum
- +1.1% 7dEstablished
Orca is a desktop development environment for running multiple AI coding agents side by side, with each task isolated in its own Git worktree. It can launch agents such as Claude Code, Codex, Cursor CLI and OpenCode, while keeping terminals, files, diffs and browser sessions tied to each worktree. The project is aimed at developers who already use coding-agent command-line tools and want one place to manage several sessions. Orca runs on macOS, Windows and Linux. Worktrees can run locally, on SSH machines or on a remote Orca server that you control. Its built-in browser includes a Design Mode that can send an element's HTML, CSS and screenshot to an agent. The CLI can create worktrees, control terminals, open files and diffs, and automate Orca's browser. A mobile companion for iOS and Android can monitor sessions, send replies, inspect files and source control, and receive completion notifications. Orca does not provide an AI model or hosted compute. You bring the coding-agent accounts or subscriptions you already use, and remote execution uses machines or cloud accounts under your control.
- Stars
- 91K
- Language
- TypeScript
- License
- MIT
- Momentum
- +7.8% 7dEstablished
Related AI tools
GitHub Copilot
Coding & dev tools
GitHub's AI coding assistant for code completion, chat, agent mode, code review and cloud agents across editors, the CLI and GitHub.
FreemiumFree tierVerifiedClaude Code
Coding & dev tools
Anthropic's coding agent that reads a codebase, edits files and runs commands from the terminal, IDE, desktop app or web.
PaidAPIVerifiedCursor
Coding & dev tools
An AI code editor and coding agent that plans, writes and reviews code on your desktop, in the terminal, in Slack and in the cloud.
FreemiumFree tierAPIVerifiedRefs
Image & video
Video reference library that turns launch films and explainers into blueprints and prompt recipes Claude and other agents can build from.
FreemiumFree tierVerifiedPolylane
Evaluation & observability
Watches production logs, metrics and traces, investigates issues and opens pull requests with fixes for your team to review.
FreemiumFree tierAPIVerified