search-claude-sessions

Installation
SKILL.md

Search Claude Sessions

Search an incremental SQLite FTS5 index of Claude Code transcripts. It indexes user prompts, assistant text, and one summary per tool call. To read one whole session instead, use read-claude-session.

Search

python3 <skill-dir>/scripts/session_search.py search "<terms>"

Every command except detail refreshes the index for its scope first. Only bytes appended since the last run are read, so the refresh takes well under a second. The first run over a large history takes about 10 seconds per GB of JSONL.

Query rules:

  • Space-separated terms must all match. Matching is case-insensitive substring matching, so push also matches unpushed.
  • Quote a phrase inside the query: search '"git push" origin'.
  • Terms of one or two characters, common in Chinese, use a slower substring scan. Results stay correct.
  • --fts passes the query to FTS5 unchanged for OR, NOT, and NEAR. Each FTS5 term needs at least 3 characters (trigram tokenizer).
Installs
2
Repository
pionxzh/skills
First Seen
Oct 25, 2026