🧠 CodeMemory

Постоянный интеллектуальный слой для кодовых баз
Локальный, ориентированный на конфиденциальность CLI-инструмент и сервер Model Context Protocol (MCP) для ИИ-агентов.

🌐 Официальный сайт и документация: https://codemem.vercel.app/

⚡ Ключевые особенности

• 🔒 100% локально и конфиденциально: Ноль телеметрии, ноль внешних сетевых вызовов. Все данные интеллекта хранятся локально в режиме SQLite WAL.

• 🌐 Интерактивный веб-обозреватель архитектуры: Локальная визуальная блок-схема и панель памяти с прокруткой по временной шкале и обновлениями в реальном времени.

• ⚡ Эффективность токенов: Минимизирует потребление токенов в промптах ИИ, предоставляя целевые срезы контекста и графы вызовов вместо сырых файлов.

• 🔍 Многоязычный AST-анализ: Извлекает функции, классы, интерфейсы, структуры и импорты в TypeScript/JavaScript, Python, Rust, Go, SQL и других языках.

• 👀 Живой наблюдатель в реальном времени: Мгновенно обнаруживает изменения кода с дебаунсингом 100 мс и интеграцией с .gitignore.

• 🤖 Встроенный MCP-сервер: Готов к подключению к Antigravity, Claude Desktop, Cursor, Copilot и пользовательским ИИ-агентам.

• 📊 Визуализатор архитектуры: Генерирует живые диаграммы Mermaid, документацию Markdown и JSON-карты.

Related MCP server: Graft

🚀 Быстрый старт

1. Установка

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

# Install dependencies
npm install

# Build TypeScript
npm run build

2. Основные команды

# 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

🤖 Подключение к ИИ-агентам через MCP

CodeMemory предоставляет полноценный сервер Model Context Protocol (MCP) stdio.

Доступные MCP-инструменты

Конфигурация Antigravity и Claude Desktop

Добавьте следующее в вашу конфигурацию MCP (mcp_config.json или claude_desktop_config.json):

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

🏗️ Архитектура

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

📜 Лицензия

Лицензия MIT - Copyright (c) 2026 Eldrex Delos Reyes Bula.