Install Codebase Memory MCP on macOS, Linux, and Windows

Codebase Memory MCP ships as a single static binary with zero runtime dependencies — no Docker, no Node.js runtime, no Python interpreter, no API keys. Every release is checksummed, signed, and scanned by 70+ antivirus engines before publication. Pick the installation method that fits your workflow: the one-line installer handles everything automatically, or choose a package manager you already use.

Platform Binaries

Every release publishes pre-built, statically-linked binaries for all supported platforms, available from the GitHub Releases page. A checksums.txt file with SHA-256 hashes is included in every release.

Platform	Standard	With Graph UI
macOS (Apple Silicon)	`codebase-memory-mcp-darwin-arm64.tar.gz`	`codebase-memory-mcp-ui-darwin-arm64.tar.gz`
macOS (Intel)	`codebase-memory-mcp-darwin-amd64.tar.gz`	`codebase-memory-mcp-ui-darwin-amd64.tar.gz`
Linux (x86_64)	`codebase-memory-mcp-linux-amd64.tar.gz`	`codebase-memory-mcp-ui-linux-amd64.tar.gz`
Linux (ARM64)	`codebase-memory-mcp-linux-arm64.tar.gz`	`codebase-memory-mcp-ui-linux-arm64.tar.gz`
Windows (x86_64)	`codebase-memory-mcp-windows-amd64.zip`	`codebase-memory-mcp-ui-windows-amd64.zip`

The Linux release also ships a -portable build (e.g. codebase-memory-mcp-linux-amd64-portable.tar.gz) that is fully statically linked and works on older distributions such as Debian 11, RHEL 8, and Ubuntu 20.04 where the standard binary’s glibc 2.38+ requirement is not met. The installer script selects the portable build automatically on Linux.

Quick Install

macOS / Linux
Windows (PowerShell)

The installer downloads the correct binary for your OS and architecture, verifies the SHA-256 checksum, installs to ~/.local/bin, and automatically configures all detected coding agents.Standard install:

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

With graph visualization UI (serves at http://localhost:9749):

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

Custom install directory:

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --dir=/usr/local/bin

Binary only (skip agent configuration):

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

If ~/.local/bin is not in your PATH, the installer will print the exact line to add to your shell config:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

The PowerShell installer downloads and extracts the binary, verifies its checksum, installs to %LOCALAPPDATA%\Programs\codebase-memory-mcp, adds it to your user PATH, and configures all detected coding agents.

# 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

With graph visualization UI:

.\install.ps1 --ui

Binary only (skip agent configuration):

.\install.ps1 --skip-config

Windows SmartScreen may show a security warning for unsigned software. Click “More info” → “Run anyway”. You can independently verify the binary’s integrity against checksums.txt published in the release.

Installer Options

Flag	Description
`--ui`	Install the UI variant, which includes the built-in 3D graph visualization server at `http://localhost:9749`.
`--skip-config`	Download and install the binary only; skip automatic agent configuration.
`--dir=<path>`	Install to a custom directory instead of the default (`~/.local/bin` on macOS/Linux, `%LOCALAPPDATA%\Programs\codebase-memory-mcp` on Windows).

Package Managers

Homebrew (macOS / Linux)

brew tap deusdata/codebase-memory-mcp https://github.com/DeusData/codebase-memory-mcp
brew install codebase-memory-mcp

AUR (Arch Linux)

yay -S codebase-memory-mcp-bin

paru -S codebase-memory-mcp-bin

Package page: aur.archlinux.org/packages/codebase-memory-mcp-bin

npm

Run directly with npx, or install globally:

npx codebase-memory-mcp

npm install -g codebase-memory-mcp

PyPI

Install with pip or pipx, or run directly with uvx:

pip install codebase-memory-mcp

uvx codebase-memory-mcp

Scoop (Windows)

scoop install codebase-memory-mcp

Winget (Windows)

winget install DeusData.CodebaseMemoryMcp

Chocolatey (Windows)

choco install codebase-memory-mcp

go install

go install github.com/DeusData/codebase-memory-mcp/pkg/go/cmd/codebase-memory-mcp@latest

Build from Source

Building from source requires a C compiler, a C++ compiler, zlib, and Git. All tree-sitter grammars and other dependencies are vendored in the repository.

Prerequisites

Requirement	Check	Install
C compiler (gcc or clang)	`gcc --version` or `clang --version`	macOS: `xcode-select --install` · Linux: `apt install build-essential`
C++ compiler	`g++ --version` or `clang++ --version`	Same as above
zlib	—	macOS: included · Linux: `apt install zlib1g-dev`
Git	`git --version`	Pre-installed on most systems

Build commands

git clone https://github.com/DeusData/codebase-memory-mcp.git
cd codebase-memory-mcp
scripts/build.sh                    # standard binary
scripts/build.sh --with-ui          # with graph visualization
# Binary output: build/c/codebase-memory-mcp

Then run ./build/c/codebase-memory-mcp install to configure your agents.

Manual MCP Configuration

If you used --skip-config or prefer to manage your agent configuration manually, add the following to your agent’s MCP configuration file. For Claude Code — add to ~/.claude/.mcp.json (global) or .mcp.json in your project root:

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Replace /path/to/codebase-memory-mcp with the absolute path to the installed binary (e.g. /home/yourname/.local/bin/codebase-memory-mcp). Restart your agent after saving the file. In Claude Code, run /mcp to verify — you should see codebase-memory-mcp listed with 14 tools.

For other agents (Codex CLI, Gemini CLI, Zed, VS Code, OpenCode, KiloCode, Aider, Antigravity, OpenClaw, Kiro), run codebase-memory-mcp install to let the tool write the correct config format for each agent automatically.

Install via Claude Code

You can ask Claude Code to install the server directly using natural language:

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

Claude Code will handle downloading, verifying, and configuring the server.

Update

codebase-memory-mcp update

Checks GitHub Releases for the latest version and replaces the binary in-place. The MCP server also checks for updates on startup and notifies on the first tool call if a newer release is available.

Uninstall

codebase-memory-mcp uninstall

Removes all agent configuration entries, instruction files, skills, and pre-tool hooks written by the installer. The binary itself and the SQLite databases at ~/.cache/codebase-memory-mcp/ are not removed — delete them manually if you want a complete clean:

rm -rf ~/.cache/codebase-memory-mcp/
rm ~/.local/bin/codebase-memory-mcp

Get Started

Core Concepts

Guides

Reference

Operations

Install Codebase Memory MCP on macOS, Linux, and Windows

Platform Binaries

Quick Install

Installer Options

Package Managers

Homebrew (macOS / Linux)

AUR (Arch Linux)

npm

PyPI

Scoop (Windows)

Winget (Windows)

Chocolatey (Windows)

go install

Build from Source

Prerequisites

Build commands

Manual MCP Configuration

Install via Claude Code

Update

Uninstall

Build docs developers (and LLMs) love

Get Started

Core Concepts

Guides

Reference

Operations

Documentation Index

​Platform Binaries

​Quick Install

​Installer Options

​Package Managers

Homebrew (macOS / Linux)

AUR (Arch Linux)

npm

PyPI

Scoop (Windows)

Winget (Windows)

Chocolatey (Windows)

go install

​Build from Source

​Prerequisites

​Build commands

​Manual MCP Configuration

​Install via Claude Code

​Update

​Uninstall

Build docs developers (and LLMs) love

Platform Binaries

Quick Install

Installer Options

Package Managers

Build from Source

Prerequisites

Build commands

Manual MCP Configuration

Install via Claude Code

Update

Uninstall