Claude Engram

Постоянная память и интеллектуальный анализ сессий для ИИ-ассистентов программирования. Подключается к жизненному циклу Claude Code для автоматического отслеживания ошибок, решений и контекста, а затем анализирует всю историю ваших сессий, чтобы выявлять закономерности, предсказывать ваши потребности и искать по всему, что вы когда-либо обсуждали.

Никаких ручных действий. Работает с любым MCP-совместимым клиентом.

Что он делает

Автоматически (хуки — без вызова):

• Отслеживает каждое изменение, ошибку, результат теста и событие сессии

• Автоматически фиксирует решения из ваших промптов («давай используем X», «переключимся на Y»)

• Внедряет 3 наиболее релевантных воспоминания перед каждым редактированием файла

• Предупреждает, когда вы собираетесь повторить прошлую ошибку

• Обнаруживает циклы редактирования (один и тот же файл 3+ раза без прогресса)

• Сохраняется при сжатии контекста — создает контрольные точки до и восстанавливает их после

• Анализирует историю сессий в фоновом режиме после каждой сессии

Анализ сессий (автоматически, в фоновом режиме):

• Разбирает полные логи разговоров Claude Code (JSONL) после каждой сессии, включая разговоры с субагентами (Explore, Plan, code-reviewer и т. д.)

• Извлекает решения, ошибки, подходы и исправления пользователя с помощью структурного анализа + семантической оценки AllMiniLM (устойчив к опечаткам)

• Создает индекс для поиска по всем прошлым разговорам (20 тыс.+ фрагментов с субагентами)

• Обнаруживает повторяющиеся трудности, шаблоны ошибок и корреляции при редактировании файлов

• Предсказывает, какие файлы и контекст вам понадобятся перед редактированием

• Анализирует закономерности с помощью локальной LLM для синтеза первопричин и архитектурных инсайтов

• При первой установке ретроспективно анализирует всю историю ваших сессий

По запросу (инструменты MCP):

• memory — хранение, поиск, архивирование и управление воспоминаниями

• session_mine — поиск по прошлым разговорам, поиск решений, повтор истории файлов, обнаружение закономерностей

• work — логирование решений и ошибок с обоснованием

• Плюс: защита области видимости, контрольные точки контекста, отслеживание соглашений, анализ влияния

Related MCP server: Doclea MCP

Как это работает

Claude Code
 |
 +-- Hooks (remind.py) <- Intercepts every tool call
 | SessionStart / Edit / Bash / Error / Compact / Stop
 |
 +-- Session Mining (mining/) <- Background intelligence
 | JSONL parser -> Extractors -> Search index -> Pattern detection
 |
 +-- MCP Server (server.py) <- Tools for manual operations
 | memory, session_mine, work, scope, context, ...
 |
 +-- Scorer Server (scorer_server.py) <- Persistent AllMiniLM process
 TCP localhost, ~90MB RAM, batch embeddings

Хуки срабатывают при каждом вызове инструмента (бюджет 1-2 сек на каждый). Тяжелая обработка происходит в фоновом подпроцессе после завершения сессии. Сервер оценки остается загруженным в памяти для быстрой семантической оценки.

Бенчмарки

Бенчмарки интеграции

Они проверяют, что продукт делает на самом деле.

Воспроизведение: python tests/bench_integration.py, bench_session_mining.py, bench_obsidian_vault.py

Бенчмарки поиска

Только поиск (recall@k) — найдено ли правильное воспоминание в топовых результатах.

Воспроизведение: python tests/bench_longmemeval.py, bench_locomo.py, bench_convomem.py

Совместимость

Установка

git clone https://github.com/20alexl/claude-engram.git
cd claude-engram
python -m venv venv
source venv/bin/activate # or venv\Scripts\activate on Windows

pip install -e . # Core
pip install -e ".[semantic]" # + AllMiniLM for vector search and semantic scoring

python install.py # Configure hooks, MCP server, and /engram skill

Настройка для проекта

python install.py --setup /path/to/your/project

Или скопируйте .mcp.json в корень вашего проекта.

Примечание: Файл CLAUDE.md в этом репозитории — это документация, специфичная для engram; она не требуется для работы engram. Хуки срабатывают автоматически, а навык /engram предоставляет быструю справку по запросу. Если у вас уже есть CLAUDE.md для вашего проекта, оставьте его как есть и не перезаписывайте нашим. Если вы хотите видеть документацию engram рядом с правилами вашего проекта, переименуйте её в CLAUDE-ENGRAM.md (или аналогично), чтобы она не заменяла ваш существующий файл — Claude увидит её, когда это будет уместно.

Обновление

cd claude-engram
git pull
pip install -e ".[semantic]" # Reinstall if dependencies changed
python install.py # Re-run to update hooks and /engram skill

Хуки и инструменты MCP подхватывают изменения кода немедленно (editable install). Переподключите MCP-сервер в Claude Code (/mcp), чтобы перезагрузить процесс сервера.

Внедрение в середине проекта

Уже глубоко в проекте? Устанавливайте как обычно. В первой же сессии engram автоматически обнаружит вашу существующую историю сессий Claude Code и проанализирует её в фоновом режиме — извлекая решения, ошибки и закономерности из всех прошлых разговоров. Никаких ручных усилий.

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

Система памяти

• Гибридный поиск — ключевые слова + вектор AllMiniLM + переранжирование. Без ChromaDB.

• Оцениваемое внедрение — топ-3 воспоминания по совпадению файлов, тегам, недавности, важности перед каждым редактированием.

• Многоуровневое хранение — горячее (быстрое) + архив (холодное, доступное для поиска, восстанавливаемое). Правила и ошибки никогда не архивируются.

• Мультипроектность — воспоминания ограничены подпроектами. Правила рабочего пространства каскадно передаются вниз.

Анализ сессий

• Структурное извлечение — анализирует поток разговора (подтверждения, перенаправления, последовательности «ошибка -> исправление», изменения подхода) вместо сопоставления по шаблонам.

• Индексация содержимого инструментов — bash-команды + вывод, diff-редактирования и трассировки ошибок доступны для поиска наряду с текстом разговора.

• Пакетные эмбеддинги — в 22 раза быстрее, чем отдельные вызовы через пакетный протокол TCP.

• Сквозной поиск по сессиям — проиндексировано 44 тыс.+ фрагментов разговоров, семантический + ключевые слова + гибридный поиск.

• Обнаружение закономерностей — повторяющиеся трудности, шаблоны ошибок, корреляции правок между сессиями.

• Предиктивный контекст — перед правками выводит связанные файлы и вероятные ошибки из истории.

• Обучение между проектами — агрегирует закономерности по всем вашим проектам.

• Ретроактивная загрузка — анализирует всю существующую историю сессий при первой установке.

• Автозапуск оценщика — сервер AllMiniLM запускается по запросу, если не запущен. Никакой «тихой» деградации.

Жизненный цикл

• Автозахват решений — структурные паттерны (подтверждения, перенаправления, явный выбор) + семантическая оценка как бонус.

• Автоотслеживание ошибок от любого неудачного инструмента. Логирует только ошибки в файлах проекта (фильтрует временный шум). Предупреждает перед повторными правками.

• Выживаемость при сжатии — контрольные точки с решениями/ошибками сессии, повторное внедрение после.

• Обнаружение циклов правки — помечает, когда один и тот же файл редактируется 3+ раза без прогресса.

Конфигурация

Переиндексация

Если качество поиска низкое или вы хотите пересобрать индекс после обновления:

python scripts/reindex.py "E:\workspace" --force # rebuild search index
python scripts/reindex.py "E:\workspace" --force --extract # also re-extract decisions/mistakes

Или через MCP: session_mine(operation="reindex", mode="bootstrap")

Документация

Книга библиотеки — философия дизайна, внутреннее устройство, полное руководство по использованию, справочник API, подводные камни и журнал изменений.

/engram — слэш-команда с быстрой справкой по инструментам (устанавливается через install.py).

Лицензия

MIT

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• audit_batchC
• claude_engram_statusB
• code_pattern_checkC
• code_quality_checkC
• contextA
• conventionB
• deps_mapC
• file_summarizeC