Claude Self-Reflect MCP
Локальная память для Claude Code: бинарный файл индексирует прошлые разговоры и подставляет нужный контекст в новые сессии.
- 230 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Индекс хранит разговоры целиком, включая вставленный код и ключи, которые попали в историю Claude Code.
- Шесть хуков срабатывают на каждом событии сессии и добавляют контекст в промпты.
- Необязательные ИИ-нарративы запускают `claude -p` на вашей подписке и тратят ее лимиты.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/ramakay/claude-self-reflect/main/scripts/install.sh | shПервый вариант README. Альтернативы: `npm install -g claude-self-reflect` с последующим `csr-engine setup` и сборка из исходников.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Индекс хранит разговоры целиком, включая вставленный код и ключи, которые попали в историю Claude Code.
- Шесть хуков срабатывают на каждом событии сессии и добавляют контекст в промпты.
- Необязательные ИИ-нарративы запускают `claude -p` на вашей подписке и тратят ее лимиты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Self-Reflect — память для Claude Code в одном бинарном файле `csr-engine` размером около 44 МБ. Он индексирует прошлые разговоры и возвращает нужный контекст в новых сессиях. Хранилище построено на SQLite, поиск на HNSW, а эмбеддинги FastEmbed считает локально, поэтому Docker, базы данных и ключи API не нужны. Установка регистрирует MCP-сервер и шесть хуков жизненного цикла: `SessionStart`, `UserPromptSubmit`, `PostToolUse`, `Stop`, `PreCompact` и `SessionEnd`. Хуки подставляют контекст до ответа Claude и сохраняют итоги сессии. Для явного поиска есть 15 MCP-инструментов, среди них `csr_reflect_on_past`, `search_by_recency`, `csr_search_by_file`, `csr_why` и `store_reflection`. Необязательные ИИ-нарративы запускают `claude -p` на вашей подписке и улучшают качество поиска. Отключаются переменной `CSR_NO_AI_NARRATIVES=1`.
Для кого. Пользователи Claude Code с долгими проектами, которым надоело заново объяснять решения, баги и устройство кода в каждой сессии.
Подходит, если
- Вы спрашиваете, как в прошлый раз решали проблему с лишними перерисовками компонента.
- Нужно найти, какие разговоры затрагивали конкретный файл или функцию (`csr_search_by_file`, `csr_code_graph`).
- Начало новой сессии должно сразу показывать связанный контекст прошлой работы.
- Надо понять происхождение решения: почему отказались от прежнего подхода (`csr_why`).
Не подходит, если
- Переписка с агентом содержит ключи и закрытые данные, которые нельзя хранить в локальном индексе.
- Вы работаете не в Claude Code: хуки и импорт рассчитаны на его историю разговоров.
- Подписку Claude нельзя тратить на фоновые ИИ-нарративы.
Пример запроса к агенту
Найди, как мы решали проблему с авторизацией в этом проекте, и покажи, в каких сессиях это обсуждали.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
`CSR_AUTO_SETUP`- Значение 1 разрешает неинтерактивной установке сразу выполнить активацию.
`CSR_NO_AI_NARRATIVES`- Значение 1 отключает необязательные ИИ-нарративы.
`CSR_NARRATIVE_MODEL`- Закрепляет модель для ИИ-нарративов.
Ограничения
Готовые бинарные файлы есть для macOS на Apple Silicon, Linux x86_64 и WSL и Linux ARM64. На macOS с Intel собирают из исходников. Активация идет только с вашего согласия, после нее перезапустите Claude Code. Первый запуск медленный, примерно 14 секунд на перестройку индекса. Индекс хранит полный текст разговоров из `~/.claude/projects/`. ИИ-нарративы расходуют токены подписки; счетчик показывает `csr-engine status`.
Как отключить. Выполните `claude mcp remove claude-self-reflect`, удалите `~/.claude-self-reflect/` и `~/.local/bin/csr-engine`, при установке через npm выполните `npm uninstall -g claude-self-reflect`. Хуки, добавленные установкой, проверьте и уберите из настроек Claude Code.
Частые вопросы
Как установить Claude Self-Reflect?
Выполните `curl -fsSL https://raw.githubusercontent.com/ramakay/claude-self-reflect/main/scripts/install.sh | sh`. Скрипт скачивает бинарный файл с проверкой SHA256 и спрашивает согласие на активацию. Перезапустите Claude Code.
Нужны ли ключи API или Docker?
Нет. Хранилище, поиск и эмбеддинги работают локально внутри одного процесса. Доступ к Claude (ключ Anthropic или подписка) нужен только для необязательных ИИ-нарративов.
Как поставить через npm?
`npm install -g claude-self-reflect`, затем отдельным шагом `csr-engine setup`. Без этого шага установка `~/.claude` не трогает.
Как отключить ИИ-нарративы?
Задайте `CSR_NO_AI_NARRATIVES=1`. Модель можно закрепить переменной `CSR_NARRATIVE_MODEL`.
Что делает хук SessionStart?
Показывает релевантный контекст прошлых разговоров в начале сессии. Остальные хуки подставляют контекст перед ответом, отслеживают правки файлов, сохраняют итоги итераций и сессии и делают резервную копию состояния перед сжатием контекста.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПлагин для Claude Code, который хранит память между сессиями в одном локальном файле, без базы, облака и ключей API
Плагин Claude Code, который ловит ваши поправки в диалоге и после проверки записывает их в CLAUDE.md и AGENTS.md
cc-lens
Claude Code Lens (cc-lens)
Локальная аналитика Claude Code: панель по сессиям, токенам, расходам и проектам из данных каталога ~/.claude, без облака
MCP-сервер и CLI, которые находят в сессиях Claude Code и Codex, почему файл стал таким: кто и о чем просил агента, когда и что изменилось
Локальный веб-редактор конфигурации Claude Code: показывает вес проектов, удаляет старые истории чатов и правит MCP-серверы
Скилл поиска по прошлым сессиям: полнотекстовый индекс переписок Claude Code, Codex, pi и Grok в одной SQLite-базе
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Claude Self-Reflect (эта карточка) | нет | не нужна | 230 | |
| Claude-Mem | нет | 113 534 | другой плагин памяти для Claude Code; Claude Self-Reflect работает как один локальный бинарный файл на Rust с SQLite и HNSW без внешних сервисов | |
| Episodic Memory | нет | 499 | плагин эпизодической памяти; здесь 15 MCP-инструментов и 6 хуков, а поиск связывает код с разговорами |
Коротко о README
Проект заменил версию 7 на Python и Docker одним бинарным файлом на Rust. Данные разговоров в `~/.claude/projects/` остаются нетронутыми, а индекс собирается заново из тех же файлов JSONL.