session-search

Searches a session topic graph to find and load past agent session transcripts.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill session-search-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-search
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/session-search
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill session-search-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It answers the question "which of my past agent sessions was about X" by searching a pre-built topic graph of session history, then loading the winning session's transcript into the current conversation so prior context is not lost. ## Core Features & Use Cases - Ranked Topic Search: Queries the session-brain graph with TF-IDF similarity, cluster lift, bookmark boost, and time decay, with filters for project, cluster, date, and result count. - Honest Result Presentation: Shows a compact table of top matches and clearly flags history-only sessions whose transcripts have been pruned from disk. - Safe Transcript Loading: Hands off to loader skills when available, or reads JSONL transcripts directly with size checks and human-turn filtering to avoid loading tens of megabytes. - Use Case: You remember fixing a telemetry bug weeks ago but not where. Run a topic query, review the ranked matches, and load the relevant session's transcript to recover the exact approach you used. ## Quick Start Ask the agent to find the session where you worked on a specific topic, for example by saying "find the session where I fixed the telemetry bug".

Frequently Asked Questions about session-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a past agent session by topic?

Run the sessions-query command with your topic to search the session-brain graph. Results are ranked by text similarity, topic cluster membership, bookmarks, and time decay, and the top matches are shown with an explanation of why each matched.

How do I search session history by project or date?

Use the filters --project NAME, --cluster N, --since DATE, and --top N with the sessions-query command. These narrow the ranked results to a specific project, topic cluster, or time window.

What happens if the session transcript was deleted?

Sessions with pruned transcripts are marked loadable: false and listed as history-only. Only their prompt text survives, so answers must be synthesized from those prompts and the skill states that the full transcript is gone.

Why does session search say to run sessions-build first?

The query command exits with an error when no graph.json exists, because search depends on the topic graph built by the session-brain skill. You must build or refresh the graph before searching, and graphs older than about seven days should be rebuilt.

Can I load a large session transcript without running out of context?

Yes, but never read the whole JSONL file since transcripts can be tens of megabytes. Check the line count first, then filter to human turns only with a Python snippet that skips sidechain and meta records.