Claude Code записывает каждую сессию на диск — вот как их индексировать и вспоминать

Claude Code с самого начала записывает все сессии в ~/.claude/projects/ в виде append-only JSONL-лога. Каждая строка — структурированный JSON-объект (роль, временная метка, содержимое, вызовы инструментов), формирующий полную запись эпизодов, начиная с первой сессии. Один пользователь обнаружил 1026 сессий общим объемом 57 МБ и 76 000 шагов, которые просто лежали на диске без возможности их запросить.

Создание слоя восстановления контекста

Решение — open-source индексатор (continuity-v2, лицензия MIT), который загружает эти логи в SQLite+FTS5 с временными связями между шагами, плюс MCP-сервер. Теперь из любой сессии Claude Code можно выполнить:

search_sessions("помнишь, как мы исправляли ту ошибку с аутентификацией в прошлом месяце")
recall_session("a8f2c441")
thread_recall(root_id, depth=8)

Функция thread_recall выполняет обход в ширину по графу временных связей, чтобы восстановить цепочку сообщений через границы сессий. Индексатор также поддерживает импорт conversations.json из экспорта данных claude.ai, так что история веб-чата хранится в том же индексе, что и сессии CLI.

Исправление жесткого сброса при компактификации

Компактификация срабатывает при заполнении контекста, но поле transcript_path в полезной нагрузке PreCompact не всегда заполняется в момент срабатывания хука. Исправление: записывать контрольную точку после каждого шага (а не только в конце сессии), чтобы PreCompact всегда имел свежие данные для отката. Затем SessionStart читает поле source — "compact" означает срабатывание компактификации, "resume" — перезапуск приложения, "startup" — новая сессия, "clear" — намеренная очистка. Для каждого — свое поведение. Итог: компактификация становится промахом кэша, а не жестким сбросом.

Обсуждение и похожие проекты

Следите за обсуждением на anthropics/claude-code#47023. Семь независимых проектов по памяти (Bella, NEXO Brain, Cozempic, world-model-mcp и др.) независимо пришли к тем же требованиям. Там разрабатывается формальная спецификация хуков.

Настройка хуков занимает около пяти минут; MCP-сервер — это один Python-файл. Репозиторий распространяется по лицензии MIT.