Skip to main content
Glama
Sign In
deenesjakoruzh
codememory

codememory

by EldrexDelosReyesBula
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

🧠 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: ContextAtlas

🚀 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

# Launch the interactive local Web Explorer (auto-opens browser)
npm run dev -- web
# or with explicit launch mode
npm run dev -- web --mode auto
npm run dev -- web --mode manual

# Start in background daemon mode
npm run dev -- web --daemon

# Start the live background file watcher (quiet mode available)
npm run dev -- watch
npm run dev -- watch --quiet

# 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": "npx",
      "args": ["-y", "@eldrex/codememory", "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

🔌 Optional Integrations

CodeMemory works 100% standalone out-of-the-box. When used alongside DevDiff, you can leverage optional integration commands:

# Verify synchronization between Git-tracked files and CodeMemory index
codememory devdiff sync

# Check for untracked or unindexed files in workspace
codememory devdiff compare

# Analyze direct and indirect caller dependencies for specific files
codememory devdiff impact src/cli.ts

# View file change records and AST symbols
codememory devdiff explain src/cli.ts

# Start Unified MCP Server (combines CodeMemory and DevDiff tools)
codememory mcp --unified

📜 License

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Graft

      amaar-mc
      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
      10 npm
      1
      MIT

    • ContextAtlas

      codefromkarl
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI coding agents to retrieve and manage code context with hybrid search, project memory, and observability via MCP tools.
      30
      MIT

    • codegraph-ai

      jotaseme
      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.
      13 npm
      1
      MIT