Session Finder

Commands

Index sessions

python3 ~/.claude/skills/session-finder/scripts/session_finder.py index [--max-age-days 90]

Search

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

Open best match directly

python3 ~/.claude/skills/session-finder/scripts/session_finder.py open "query"

Stats

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

1. Run

   search

   with their query
2. Present results with confidence scores
3. Offer to resume the top match via

   claude --resume <id>