codebase-memory-mcp tutorial: add codebase memory to Claude Code and Codex

Mon, 22 Jun 2026 08:05:45 +0800

DeusData/codebase-memory-mcp is a code intelligence MCP server. It indexes a codebase into a persistent knowledge graph, helping agents such as Claude Code, Codex, Gemini CLI, Aider, and OpenCode query project structure faster.

Project repository:

https://github.com/DeusData/codebase-memory-mcp

Documentation site:

https://deusdata.github.io/codebase-memory-mcp/

One-line Installation

macOS / Linux:

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

If you also want to install the graphical interface:

`1`	`curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh \| bash -s -- --ui`

Windows:

# 1. Download the installer
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1

# 2. (Optional but recommended) Inspect the script
notepad install.ps1

# 3. Run it
.\install.ps1

Manual Installation

After extracting on macOS / Linux:

1
2

tar xzf codebase-memory-mcp-*.tar.gz
./install.sh

Windows:

1
2

Expand-Archive codebase-memory-mcp-windows-amd64.zip -DestinationPath .
.\install.ps1

Open the UI

`1`	`codebase-memory-mcp --ui=true --port=9749`

Auto Indexing and Updates

Enable auto indexing:

`1`	`codebase-memory-mcp config set auto_index true`

Update:

`1`	`codebase-memory-mcp update`

Uninstall:

`1`	`codebase-memory-mcp uninstall`

How to Use It

It fits large codebases where agents repeatedly read the same files. For example:

A legacy project has a complex structure and AI often picks the wrong entry point.
A multi-language repository needs fast dependency lookup.
You want to reduce the number of files an agent pushes into context.
You want to share one code memory through MCP across multiple coding tools.