Memento Vault: Локальный инструмент для сохранения контекста в сессиях Claude Code

Memento Vault решает проблему потери контекста Claude Code между сессиями, автоматически захватывая и извлекая релевантную информацию без ручного обслуживания.

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

Инструмент использует хуки, которые подключаются к жизненному циклу Claude Code:

• По завершении сессии: Хук читает транскрипт, оценивает его и решает, что сохранить. Значимые сессии превращаются в атомарные заметки, записываемые в локальный git-репозиторий. Каждая заметка содержит одну идею с метаданными, включая оценки уверенности и теги, а также вики-ссылки на связанные заметки. Незначительные сессии получают краткую запись в ежедневном логе.
• При запуске сессии: Он вводит краткий обзор, показывающий ваши недавние сессии по проекту и наиболее релевантные заметки из хранилища для предстоящей работы.
• При каждом запросе: Он ищет в вашем хранилище и показывает подходящие заметки до того, как Claude обработает ваш ввод.
• При каждом чтении файла: Он добавляет контекст о ранее изменённых участках кода.

Технические детали

Весь поиск использует локальный BM25 + векторный поиск без вызовов LLM. Система имеет среднюю задержку 472 мс на запрос и не требует затрат на работу. Накладные расходы на контекст составляют примерно 149 единиц ввода на сессию. Качество поиска оценивается как NDCG@10 = 0,892 на LongMemEval (500 вопросов).

Фоновый слой консолидации под названием Inception группирует заметки по сходству эмбеддингов и создаёт паттерн-заметки после сессий, выявляя повторяющиеся проблемы в проектах.

Вся система использует файлы в формате markdown в git-репозитории, которые можно просматривать в Obsidian, искать с помощью grep и сравнивать с помощью git log. Нет зависимости от баз данных, Docker или облачных сервисов.

Установка

git clone https://github.com/sandsower/memento-vault.git
cd memento-vault
./install.sh --experimental

Требования: Python 3 и Claude Code. QMD добавляет семантический поиск (опционально). Работает на Linux и macOS.

Проект включает 271 тест и распространяется под лицензией MIT.