DeusData/codebase-memory-mcp

Quick Start

The standard native release includes CBM Lens. Start it after installation with codebase-memory-mcp daemon start --open --port=9749. The Nix packages and source builds also offer builds without the UI.

Options: --skip-config (binary only, no agent setup), --dir= (custom location).

The install command automatically strips macOS quarantine attributes and ad-hoc signs the binary; no manual xattr/codesign needed.

• Download the archive for your platform from the latest release:
• codebase-memory-mcp--.tar.gz (macOS/Linux) or .zip (Windows)
• Extract and install (each archive includes install.sh or install.ps1):
• Restart your coding agent.

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

Agent setup: skills, profiles, and hooks

Installation also equips supported coding agents to use the graph in daily work. The native install command detects clients and installs the integration pieces their documented formats support:

Hook augmentation is context-only and fail-open: it does not replace or block the requested tool call. Features vary by client and platform; some clients use durable instructions or a parent-agent handoff instead of hooks or direct subagent MCP access. Codex users review and trust installed hooks through /hooks. See Multi-Agent Support and Sessions, compaction, and subagents for exact support and activation requirements.

• MCP configuration — Connects the client to the local server and its tools.
• Instructions and skills — Explains graph-first exploration, index freshness, coverage checks, and when to read source.
• Scout, Verify, and Auditor profiles — Offers fast provisional lookup, task-directed verification, or bounded full verification, where custom agents are supported.
• Session and compaction hooks — Restores graph context at supported lifecycle events.
• Search and read hooks — Adds relevant graph context to supported searches and flags recorded coverage gaps after supported file reads.

Uninstall

Removes owned agent config entries, skills, hooks, instructions, and the installed binary. Existing graph indexes are listed and kept by default. -y/--yes, -n/--no, and noninteractive input keep them unless --delete-indexes is explicitly given. An interactive terminal without that flag is asked separately; the default answer is to keep them.

--delete-indexes is explicit consent and takes precedence over --no; --dry-run always preserves the files. When indexes are kept, uninstall prints their cache directory (${CBMCACHEDIR:-~/.cache/codebase-memory-mcp}) and how to remove them.

The install script placed beside the binary is reported, not deleted: uninstall prints its path and the rm command for it. It is left alone on purpose: it may be your own copy, a symlink into a checkout, or managed by a package manager, and an uninstaller should not delete a file it cannot prove it owns.

codebase-memory-mcp uninstall

Infrastructure and deployment

Ask "What deploys this service?", "Which image runs it?", or "Where does this configuration reach code?" CBM connects supported infrastructure forms to the source they build, configure, and run:

For resolvable inputs, a trace can follow Service → workload → image → Dockerfile → program, or follow deployment and configuration relationships. Use tracepath modes for topology, deployment, and run paths. These are static relationships from supported source forms; dynamic values and unresolved templates can leave gaps. See Edge types for the exact relationship rules and limitations.

• Containers and clusters: Dockerfiles, Compose services, Kubernetes resources, Helm charts and releases, and Kustomize overlays and patches.
• Provisioning and configuration: Terraform/OpenTofu resources and modules, tfvars overrides, Terragrunt dependencies, Ansible tasks and handlers, and supported configuration keys and environment-variab
• Build and delivery: shell commands, Make targets, and supported CI steps that build images, invoke repository scripts, or deploy resources.

Setup Scripts

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/scripts/setup.sh | bash

Install via Claude Code

You: "Install this MCP server: https://github.com/DeusData/codebase-memory-mcp"

How It Works

codebase-memory-mcp is a structural analysis backend: it builds and queries the knowledge graph. The backend does not require a generative model. It relies on your MCP client (Claude Code, or any MCP-compatible agent) to be the intelligence layer.

With MCP, your coding agent translates a question into tool calls. CBM Lens can also use an optional browser model for explanations; this does not change how the backend indexes or queries code.