lore

Семантический поиск по вашим диалогам в Claude Code. Находите всё, что когда-либо обсуждали — во всех проектах, сессиях и ветках.

Возможности

• Гибридный поиск (векторный + по ключевым словам) Объединяет эмбеддинги multilingual-e5-small с FTS5/BM25 через Reciprocal Rank Fusion. Находит результаты как по смыслу, так и по точным терминам.

• Полностью локально, без API-ключей Всё работает на вашем компьютере. ONNX Runtime для эмбеддингов, sqlite-vec для хранения. Никакие данные не покидают ваше устройство.

• Автоматическая индексация при завершении сессии Хук SessionEnd автоматически индексирует все новые сессии в фоновом режиме. Ручной запуск не требуется.

• Фоновая индексация Ручной запуск индексации возвращает управление мгновенно. Отслеживайте прогресс, продолжая работу. Ищите по уже проиндексированным данным, пока остальное обрабатывается.

• Отказ от участия по умолчанию Все проекты индексируются автоматически. Исключайте те, которые вам не нужны. Регистрация не требуется.

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

• 100+ языков Корейский, японский, китайский, английский и более 90 других. Оценка токенов с учетом CJK для точного разбиения.

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

Добавление в Claude Code

# No install needed — always runs latest version
claude mcp add -s user lore -- npx getlore

# Or for a single project only
claude mcp add -s project lore -- npx getlore

Добавление в OpenAI Codex CLI

# No install needed
codex mcp add lore -- npx getlore

npm install -g getlore

# Then register with your tool:
claude mcp add -s user lore -- getlore   # Claude Code
codex mcp add lore -- getlore            # Codex CLI

# Manage your install:
getlore --version   # Check installed version
getlore update      # Update to latest

Использование

После подключения ИИ может напрямую использовать инструменты lore:

You: "What did we discuss about auth refactoring last week?"

Claude: [calls lore search] Found 3 relevant conversations...
        In your "my-webapp" project on March 15, you decided to...

Первичная настройка:

1. Индексация -- index() автоматически сканирует все проекты, работает в фоновом режиме

2. Поиск -- спрашивайте что угодно о прошлых диалогах

3. Исключение (опционально) -- скройте шумные проекты, которые вам не нужны

Инструменты

Зачем это нужно

Claude Code сохраняет каждый диалог как JSONL-транскрипт в ~/.claude/projects/. Через несколько недель у вас накапливаются сотни сессий в десятках проектов — обсуждения архитектурных решений, сессии отладки, код-ревью и дизайн-исследования.

Но искать по ним негде. Вы не можете спросить: "какой подход мы выбрали для middleware аутентификации?" или "в каком проекте было обсуждение миграции базы данных?"

Существующие инструменты либо требуют облачных API, либо порождают зомби-процессы, либо рассматривают диалоги как обычные документы. lore создан специально для сессий Claude Code: он понимает границы шагов, цепочки использования инструментов и блоки размышлений. Работает полностью локально без зависимостей, кроме Node.js.

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

~/.claude/projects/*/*.jsonl
        |
   JSONL Parser (extracts user/assistant messages, skips noise)
        |
   Turn-pair Chunker (groups by logical conversation turns)
        |
   Transformers.js (multilingual-e5-small, INT8 quantized, 384d)
        |
   sqlite-vec + FTS5 (hybrid vector + keyword storage)
        |
   Reciprocal Rank Fusion (combines both signals for ranking)

Хранилище: Один файл SQLite в ~/.lore/lore.db с режимом WAL для параллельного чтения.

Конфигурация: Исключения проектов хранятся в ~/.lore/config.json.

Переменные окружения

Измерено на Apple Silicon (M-series):

"Сессии не найдены"

Запустите manage_projects с действием list, чтобы увидеть доступные проекты. Все они индексируются по умолчанию, если не исключены.

Устаревший файл блокировки

Если индексация была прервана, файл блокировки автоматически очищается при следующем запуске (определение на основе PID).

Повреждение БД

Удалите ~/.lore/lore.db и переиндексируйте. Ваши исходные данные (~/.claude/projects/) никогда не изменяются.

Разработка

git clone https://github.com/hyunjae-labs/lore.git
cd lore
npm install
npm run build
npm test          # 118 tests

Технологический стек

• Model Context Protocol SDK -- транспорт stdio

• @huggingface/transformers -- multilingual-e5-small (INT8)

• better-sqlite3 + sqlite-vec -- встроенная векторная БД

• Reciprocal Rank Fusion -- ранжирование гибридного поиска

Лицензия

MIT