One-line install (macOS / Linux):
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
With graph visualization UI:
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --ui
Windows (PowerShell):
# 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
Options: --ui (graph visualization), --skip-config (binary only, no agent setup), --dir=<path> (custom location).
Restart your coding agent. Say “Index this project” — done.
If you downloaded the ui variant:
codebase-memory-mcp --ui=true --port=9749
Open http://localhost:9749 in your browser. The UI runs as a background thread alongside the MCP server — it’s available whenever your agent is connected.
Enable automatic indexing on MCP session start:
codebase-memory-mcp config set auto_index true
When enabled, new projects are indexed automatically on first connection. Previously-indexed projects are registered with the background watcher for ongoing git-based change detection. Configurable file limit: config set auto_index_limit 50000.
codebase-memory-mcp update
The MCP server also checks for updates on startup and notifies on the first tool call if a newer release is available.
codebase-memory-mcp uninstall
Removes all agent configs, skills, hooks, and instructions. Does not remove the binary or SQLite databases.
