К основному содержанию
скилл CX Codex

session-finder — скилл для Claude Code: поиск по прошлым сессиям

Скилл session-finder индексирует сессии Claude Code эмбеддингами Gemini и находит нужную по описанию задачи, а потом открывает её или предлагает claude --resume.

MIT 166 установок ★ 414 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add glebis/claude-skills --skill session-finder -a claude-code
Открыть на GitHub

Что делает session-finder

Скилл кладёт скрипт session_finder.py с четырьмя подкомандами: index, search, open и stats. Индексация разбирает JSONL каждой сессии без участия модели: берёт готовые пересказы из событий away_summary, первое сообщение пользователя с задачей, сокращённые последующие сообщения, первый ответ ассистента, список инструментов и имя проекта.

Дальше документ уходит в эмбеддинги gemini-embedding-exp-03-07 через llm CLI, вектор ложится в SQLite по пути ~/.claude/session-finder.db. Поиск считает косинусную близость по всем сессиям и выдаёт оценки совпадения. open сразу поднимает лучший результат, а в диалоге скилл предлагает продолжить через claude --resume <id>. Флаг --max-age-days ограничивает индексацию по возрасту сессий, --top задаёт длину выдачи.

Ставится на несколько платформ, но история всегда читается из ~/.claude: на Cursor или Codex поиск пойдёт по сессиям Claude Code, а не по локальной истории этих редакторов. Для запуска нужны Python 3 и llm CLI с доступом к Gemini-моделям.

Какие задачи решает

  • найти сессию, где разбирали миграцию схемы
  • восстановить контекст брошенной задачи
  • проиндексировать только свежие сессии
  • открыть лучшую находку одной командой
  • посмотреть статистику по накопленному индексу

Примеры запросов агенту

  • Найди сессию, где я настраивал деплой в fly.toml
  • Какая сессия была про парсер логов?
  • Перезапусти сессию, где мы чинили падающие тесты

Как установить session-finder

1Через Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill session-finder -a claude-code

2Вручную: положить файлы

~/.claude/skills/session-finder/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/session-finder/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о session-finder

Как установить session-finder в Claude Code?

Выполните npx skills add glebis/claude-skills --skill session-finder -a claude-code. После этого скилл лежит в ~/.claude/skills/session-finder/SKILL.md.

Что делает session-finder?

Собирает документы из прошлых сессий Claude Code, считает для них эмбеддинги и ищет по смыслу запроса. Лучший результат можно сразу открыть или продолжить через claude --resume.

Что нужно, чтобы скилл заработал?

Python 3 и llm CLI с доступом к Gemini-эмбеддингам. Индекс хранится в ~/.claude/session-finder.db.

Исходный текст

SKILL.md · MIT
---
name: session-finder
description: Index and search Claude Code sessions using semantic embeddings (Gemini). Find past sessions by topic, relaunch the best match. Triggers on "find session", "which session did I", "relaunch the session where", "session about X".
---

# Session Finder

Semantic search across Claude Code sessions using Gemini embeddings.

## Commands

### Index sessions
```bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py index [--max-age-days 90]
```

### Search
```bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py search "query" [--top 5]
```

### Open best match directly
```bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py open "query"
```

### Stats
```bash
python3 ~/.claude/skills/session-finder/scripts/session_finder.py stats
```

## How it works

1. **Document extraction** — deterministic, no LLM. Each session JSONL is parsed into a structured document:
   - `away_summary` events (pre-existing Claude recaps) if available
   - First user message (task description)
   - Follow-up user messages (condensed)
   - First assistant response
   - Tools used
   - Project name
2. **Embedding** — documents are embedded with `gemini-embedding-exp-03-07` via `llm` CLI
3. **Storage** — SQLite at `~/.claude/session-finder.db`
4. **Search** — query is embedded, cosine similarity ranks all sessions, top match is the default to open

## Workflow

When user asks to find a session:
1. Run `search` with their query
2. Present results with confidence scores
3. Offer to resume the top match via `claude --resume <id>`

© glebis · MIT · glebis/claude-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
session-brain Ar9av Скилл session-brain для Claude Code строит интерактивный граф тем по истории сессий без записи в хранилище заметок. Кластеризует диалоги и показывает связи между старыми задачами. CX Codex +1 364установок session-management secondsky Скилл session-management для Claude Code помогает настроить JWT-сессии, хранение в Redis и обновление токенов. Подключается при работе над аутентификацией, пользовательскими сессиями или выходом из аккаунта. CX Codex +1 436установок session-logger Karan Bansal Плагин session-logger для Claude Code записывает ход сессии в Markdown-файл. Хуки фиксируют репозиторий, затронутые файлы и команды Bash. ★ 586звёзд репо find-session Son Nguyen Команда find-session ищет сессии Agent Monitor по рабочей папке, модели или статусу и выводит верхние совпадения. Подходит для быстрой проверки запущенных и завершённых задач. CX Codex +1 ★ 1 198звёзд репо cookie-session-audit mrhlaingbwardev Скилл cookie-session-audit для Claude Code проверяет файлы cookies и оценивает состояние сессий. Запускается по запросу проверить cookies, сверить сессию или обработать набор файлов TXT, JSON и ZIP. CX Codex +1 ★ 326звёзд репо grepai-search-basics yoanbernabeu Скилл grepai-search-basics обучает ассистента семантическому поиску по кодовой базе через GrepAI вместо текстового поиска строк. CX Codex +1 945установок

Из того же набора51

Весь набор →
lab-retro Скилл lab-retro проводит участника Claude Code Lab через самооценку, оформление полезного промпта, план на месяц и отзыв организатору. Запускайте после обучения или по частям. CX Codex +1 182установок vision-bench Скилл vision-bench сравнивает изображения и выставляет оценки через vision LLM по YAML-критериям. Запускается для генерации отчётов, OCR, анализа графиков и проверки стиля. CX Codex +1 178установок skill-studio Скилл skill-studio проводит интервью по методике JTBD и анализирует прошлые сессии Claude Code, чтобы спроектировать спецификацию нового скилла или агента. CX Codex +1 174установок linear Скилл управляет задачами и проектами Linear через CLI. Попросите создать задачу, найти её в бэклоге или изменить статус. CX Codex +1 170установок timebuzzer-led Скилл timebuzzer-led для управления RGB LED на аппаратном устройстве timeBuzzer по протоколу MIDI. Задаёт цвет, эффекты (пульс, стробоскоп, радуга, затухание) и статус-сигналы прямо из кода. CX Codex +1 165установок session-anonymizer Скилл session-anonymizer удаляет персональные данные из заметок и транскриптов терапевтических или коучинговых сессий. Работает локально через трёхслойный пайплайн. CX Codex +1 159установок sorted Автоматизирует getSorted.de через браузер для выставления счетов, учёта расходов и подачи налоговых отчётов в Германии. CX Codex +1 151установок rag-eval Скилл rag-eval запускает сетку тестов для RAG-пайплайна с ограничением бюджета и ранжирует варианты. CX Codex +1 150установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой