session-finder — скилл для Claude Code: поиск по прошлым сессиям
Скилл session-finder индексирует сессии Claude Code эмбеддингами Gemini и находит нужную по описанию задачи, а потом открывает её или предлагает claude --resume.
MIT 166 установок ★ 414 обновлён 2026-10-23
npx skills add glebis/claude-skills --skill session-finder -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/session-finder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/session-finder/
1Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill session-finder -a codex2Вручную: положить файлы
.agents/skills/session-finder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill session-finder -a cursor2Вручную: положить файлы
.cursor/skills/session-finder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install glebis/claude-skills session-finder2Вручную: положить файлы
.github/skills/session-finder/SKILL.md1Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill session-finder -a gemini-cli2Командой платформы
gemini skills install https://github.com/glebis/claude-skills --path session-finderВручную: положить файлы
.devin/skills/session-finder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill session-finder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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