🧠 CodeMemory

Die persistente Intelligenzschicht für Codebasen
Lokal-first, datenschutzorientiertes CLI-Tool und Model Context Protocol (MCP)-Server für KI-Agenten.

🌐 Offizielle Website & Dokumentation: https://codemem.vercel.app/

⚡ Wichtigste Highlights

• 🔒 100 % lokal & privat: Null Telemetrie, keine externen Netzwerkaufrufe. Die gesamte Intelligenz wird lokal im SQLite-WAL-Modus gespeichert.

• 🌐 Interaktiver Web-Architektur-Explorer: Lokales visuelles Flussdiagramm & Memory-Dashboard mit Zeitleisten-Scrubbing und Live-Updates in Echtzeit.

• ⚡ Token-Effizienz: Minimiert den Token-Verbrauch von KI-Prompts, indem gezielte Kontextausschnitte und Aufrufergraphen statt roher Dateidumps bereitgestellt werden.

• 🔍 Mehrsprachige AST-Analyse: Extrahiert Funktionen, Klassen, Interfaces, Strukturen und Importe in TypeScript/JavaScript, Python, Rust, Go, SQL und mehr.

• 👀 Echtzeit-Live-Watcher: Erkennt Codeänderungen sofort mit 100 ms Entprellung und .gitignore-Integration.

• 🤖 Natiiver MCP-Server: Bereit für die Verbindung mit Antigravity, Claude Desktop, Cursor, Copilot und benutzerdefinierten KI-Agenten.

• 📊 Architektur-Visualisierer: Erzeugt Live-Mermaid-Diagramme, Markdown-Dokumentation und JSON-Karten.

Related MCP server: Graft

🚀 Schnellstart

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. Grundlegende Befehle

# 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

🤖 Verbindung mit KI-Agenten über MCP

CodeMemory bietet einen vollständigen Model Context Protocol (MCP)-stdio-Server.

Verfügbare MCP-Tools

Antigravity- & Claude-Desktop-Konfiguration

Fügen Sie Folgendes zu Ihrer MCP-Konfiguration hinzu (mcp_config.json oder claude_desktop_config.json):

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

🏗️ Architektur

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

📜 Lizenz

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