session-finder
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".
How do I install this agent skill?
npx skills add https://github.com/glebis/claude-skills --skill session-finderIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill enables semantic search for local Claude Code session history. To provide this functionality, it reads sensitive conversation logs and sends extracted snippets to the Google Gemini API (via the llm CLI) for embedding. It also executes commands to relaunch sessions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Session Finder
Semantic search across Claude Code sessions using Gemini embeddings.
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
- Document extraction — deterministic, no LLM. Each session JSONL is parsed into a structured document:
away_summaryevents (pre-existing Claude recaps) if available- First user message (task description)
- Follow-up user messages (condensed)
- First assistant response
- Tools used
- Project name
- Embedding — documents are embedded with
gemini-embedding-exp-03-07viallmCLI - Storage — SQLite at
~/.claude/session-finder.db - Search — query is embedded, cosine similarity ranks all sessions, top match is the default to open
Workflow
When user asks to find a session:
- Run
searchwith their query - Present results with confidence scores
- Offer to resume the top match via
claude --resume <id>
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/glebis/claude-skills/session-finder">View session-finder on skillZs</a>