Claude Info
Продуктивность

Индекс сессий Claude

lee-fuhr/claude-session-index

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

Установка

terminal
bash
npx skills add lee-fuhr/claude-session-index

README

Claude session index

Все ваши сессии Claude Code — доступны для поиска менее чем за секунду.

Вы создавали проекты в сотнях сессий. Решали задачи, упирались в стены, находили обходные пути. Но сессии оседают в ~/.claude/projects/ как безымянные JSONL-файлы — тысячи штук, без поиска, без памяти. Этот инструмент индексирует их все в быструю SQLite-базу с полнотекстовым поиском, получением контекста разговоров, аналитикой и кросс-сессионным синтезом.

Спросите «что я пробовал в прошлый раз при отладке вебхуков?» — и получите реальный ответ.


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

pip install claude-session-index

Затем установите скилл для Claude Code:

npx skills add lee-fuhr/claude-session-index

Или скопируйте вручную:

cp skills/session-index/SKILL.md .claude/skills/session-index.md

Всё. При первом запросе инструмент автоматически проиндексирует все существующие сессии. После этого запросы выполняются за миллисекунды.


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

Интерфейс — ваш диалог с Claude Code. Вы задаёте вопросы в свободной форме, Claude переводит их в поисковые запросы и отвечает в разговорном стиле.

«Мы недавно обсуждали управление браузером?»

Claude ищет по сессиям, находит совпадения и отвечает:

Управление браузером обсуждалось в 3 сессиях на прошлой неделе. Наиболее релевантная — от 18 января, где вы выяснили, что синтетическая диспетчеризация MouseEvent обходит обработку событий фреймворка. Ключевое открытие: кнопка submit была <div>, а не <button>.

claude --resume a5b111c6-dca0-4ee9-b237-74b75baf13cd

«Что я пробовал для автоматизации форм? Что сработало?»

Claude ищет по сессиям, извлекает релевантные разговоры и синтезирует:

Опробованные подходы: element.click() → не сработало (фреймворк перехватывает). Клик по координатам → не сработало (динамические элементы). Синтетическая диспетчеризация MouseEvent → успех.

Что сработало: Нативный клик на уровне ОС для всех взаимодействий с кнопками. Постоянные профили браузера для сохранения сессии.

Что не сработало: Любой JavaScript-клик — фреймворк перехватывает и блокирует.

Источники: 5 сессий с 10 января по 1 февраля → claude --resume abc123...claude --resume def456...

«Как я провёл неделю?»

89 сессий за неделю. 302 часа суммарно.

Windmill Labs: 2 сессии, 47ч GridSync: 2 сессии, 17ч NovaTech: 4 сессии, 7ч

Топ инструментов: Bash (3 214), Read (2 126), Edit (1 718) Использование Task-агента выросло на 142% по сравнению с прошлой неделей.

Каждый ответ содержит ссылки claude --resume, чтобы вы могли мгновенно вернуться в любую сессию.


Что происходит под капотом

  1. Индексирует все сессии Claude Code в SQLite с полнотекстовым поиском FTS5
  2. Ищет по содержимому, клиенту, проекту, инструменту, агенту, тегу или дате — результаты за миллисекунды
  3. Извлекает контекст — реальные фрагменты диалога (пользователь + ассистент), а не только метаданные
  4. Анализирует использование — время по клиентам, тренды инструментов, частота сессий, паттерны тем
  5. Синтезирует по сессиям — «Какие подходы я пробовал для X?» через внутренний Haiku-субагент (без дополнительных затрат на API)
  6. Отслеживает темы в реальном времени во время сессий через хуки Claude Code

CLI

Скилл обеспечивает разговорный интерфейс. Но если нужен прямой доступ из терминала, всё доступно через sessions:

bash
# Поиск — просто введите что ищете
sessions "webhook debugging"
sessions "webhook" --context              # с фрагментами разговора

# Просмотр разговора
sessions context <id> "term"              # обмены, содержащие термин
sessions context <id>                     # все обмены

# Аналитика
sessions analytics                        # общая статистика
sessions analytics --client "Acme"        # по клиенту
sessions analytics --week                 # за эту неделю
sessions analytics --month                # за этот месяц

# Синтез (требует пакет anthropic + API-ключ для автономного использования)
sessions synthesize "topic"               # кросс-сессионный анализ

# Просмотр и фильтрация
sessions recent 20                        # последние N сессий
sessions find --client "Acme"             # фильтр по клиенту
sessions find --tool Task --week          # фильтр по инструменту + дате
sessions topics <session_id>              # хронология тем
sessions tools                            # топ инструментов по всем сессиям
sessions stats                            # обзор базы данных

# Индексирование
sessions index                            # индексировать новые/изменённые сессии
sessions index --backfill                 # переиндексировать всё

Простой текст по умолчанию запускает поиск — sessions "webhook debugging" работает без подкоманды.

Вывод CLI

Результаты поиска выглядят так:

🔍 3 results for "silent failure" ◆ a5b111c6 · (unnamed) 2026-01-18 · my-project · 51 exchanges "...This was a silent failure - appeared to work but didn't..." → claude --resume a5b111c6-dca0-4ee9-b237-74b75baf13cd ◆ 7b22239e · (unnamed) 2026-01-18 · my-project · 50 exchanges "...The phrase 'silent failure, which is the ultimate sin' captures the core requirement: systems must fail loudly..." → claude --resume 7b22239e-9f90-466f-ad92-849840b2a6fd

Контекст разговора показывает реальный чат:

╭─── Build automation debugging ───────────────── │ 2026-01-20 · my-project · 96 exchanges · 7min │ → claude --resume a5b111c6-dca0-4ee9-b237-74b75baf13cd ╰──────────────────────────────────────────────── ┌─ Jan 20, 19:14 ────────────────────────────── │ │ 🧑 Breakthrough session. Successfully submitted forms #32 and #33 │ using synthetic MouseEvent dispatch to bypass the framework's │ event handling. │ │ 🤖 I'll process these findings. Let me search for existing patterns... │ [Grep: framework|zone\.js|MouseEvent|click] │ [Read: /path/to/automation/docs.md] │ └────────────────────────────────────────────────

Вызовы инструментов сворачиваются в читаемые однострочники — [Read: path], [Edit: path], [Bash: command] — без засорения вывода.


Установка

pip install claude-session-index

Требования: Python 3.8+, Claude Code с сессиями в ~/.claude/projects/.

Для синтеза через CLI (не через скилл) нужен пакет anthropic и переменная окружения ANTHROPIC_API_KEY. При использовании через скилл Claude Code синтез выполняется бесплатно через внутренний субагент.


Установка скилла

npx skills add lee-fuhr/claude-session-index

Или вручную — скопируйте skills/session-index/SKILL.md в .claude/skills/session-index.md.

После установки скилла просто спрашивайте Claude Code о своих прошлых сессиях в свободной форме.


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

По умолчанию всё работает без настройки. Опциональные переменные окружения:

  • CLAUDE_PROJECTS_DIR — путь к директории с сессиями (по умолчанию ~/.claude/projects/)
  • SESSION_INDEX_DB — путь к файлу базы данных (по умолчанию ~/.claude/session-index.db)
  • ANTHROPIC_API_KEY — нужен только для автономного синтеза через CLI

Лицензия

MIT

Похожие скиллы