Skip to main content
Glama

🧠 CodeMemory

The Persistent Intelligence Layer for Codebases
Local-first, privacy-obsessed CLI tool and Model Context Protocol (MCP) server for AI agents.

🌐 Official Website & Docs: https://codemem.vercel.app/


⚔ Key Highlights

  • šŸ”’ 100% Local & Private: Zero telemetry, zero external network calls. All intelligence stored locally in SQLite WAL mode.

  • 🌐 Interactive Web Architecture Explorer: Local visual flowchart & memory dashboard with timeline scrubbing and real-time live updates.

  • ⚔ Token Efficiency: Minimizes AI prompt token consumption by providing targeted context slices and caller graphs instead of raw file dumps.

  • šŸ” Multi-Language AST Analysis: Extracts functions, classes, interfaces, structs, and imports across TypeScript/JavaScript, Python, Rust, Go, SQL, and more.

  • šŸ‘€ Real-time Live Watcher: Detects code changes instantly with 100ms debouncing and .gitignore integration.

  • šŸ¤– Native MCP Server: Ready to connect with Antigravity, Claude Desktop, Cursor, Copilot, and custom AI agents.

  • šŸ“Š Architecture Visualizer: Generates live Mermaid diagrams, Markdown documentation, and JSON maps.


Related MCP server: Graft

šŸš€ Quick Start

1. Installation

# Clone the repository
git clone https://github.com/EldrexDelosReyesBula/CodeMemory.git
cd CodeMemory

# Install dependencies
npm install

# Build TypeScript
npm run build

2. Basic Commands

# Initialize CodeMemory in your repository
npm run dev -- init

# Scan the current codebase and index all symbols
npm run dev -- scan

# Search for any function, class, or symbol
npm run dev -- query authenticateUser

# Extract token-budgeted AI context
npm run dev -- context AuthService --budget 2000

# Start the live background file watcher
npm run dev -- watch

# Export Mermaid architecture diagram
npm run dev -- export --format mermaid

# Check repository health and statistics
npm run dev -- status

šŸ¤– Connecting to AI Agents via MCP

CodeMemory provides a full Model Context Protocol (MCP) stdio server.

Available MCP Tools

Tool

Description

codememory_search

Search code symbols, signatures, and functions

codememory_get_context

Token-budgeted context with dependencies & callers

codememory_get_dependencies

Upstream imports and downstream dependents

codememory_get_history

Recent file modifications and Git commit logs

codememory_get_architecture

Generate real-time Mermaid architecture diagrams

codememory_get_metrics

Overall codebase stats and language breakdowns

Antigravity & Claude Desktop Configuration

Add the following to your MCP configuration (mcp_config.json or claude_desktop_config.json):

{
  "mcpServers": {
    "codememory": {
      "command": "node",
      "args": ["c:/Users/Eldrex/Downloads/classhost/Needs/CodeMemory/dist/cli.js", "mcp"],
      "env": {}
    }
  }
}

šŸ—ļø Architecture

CodeMemory/
ā”œā”€ā”€ src/
│   ā”œā”€ā”€ types/          # Domain data types & contracts
│   ā”œā”€ā”€ db/             # SQLite engine with WAL mode & indexes
│   ā”œā”€ā”€ parser/         # Multi-language AST symbol & dependency extractor
│   ā”œā”€ā”€ watcher/        # Real-time debounced file watcher with .gitignore
│   ā”œā”€ā”€ git/            # Git commit and diff history monitor
│   ā”œā”€ā”€ generator/      # Mermaid diagram & Markdown/JSON exporters
│   ā”œā”€ā”€ context/        # Token-budgeted context assembly & symbol ranker
│   ā”œā”€ā”€ mcp/            # Model Context Protocol stdio server
│   └── cli.ts          # CLI commands router
└── tests/              # Complete Vitest test suite

šŸ“œ License

MIT License - Copyright (c) 2026 Eldrex Delos Reyes Bula.

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Persistent codebase knowledge layer for AI agents. Pre-digests codebases into structured knowledge (symbols, dependency graphs, co-change patterns, architectural decisions) and serves via MCP. 28 languages, 14 tools, ~85% token reduction.
    53
    7
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Local-first codebase context engine that parses code into a ranked dependency graph and serves it to AI tools via MCP for deep structural understanding.
    5
    8
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI coding agents to retrieve and manage code context with hybrid search, project memory, and observability via MCP tools.
    29
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Serves structured code context via MCP, enabling AI agents to understand codebases with dependency graphs and significantly reduce token usage.
    39
    MIT

View all related MCP servers

Related MCP Connectors

  • Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.

  • Give your AI agent a persistent map of your project's structure, dependencies, and bugs.

  • Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/EldrexDelosReyesBula/CodeMemory'

If you have feedback or need assistance with the MCP directory API, please join our Discord server