A CLI tool to search your Claude Code conversation history across all projects. Solves the problem of "I know I discussed this somewhere but can't remember which repo/session" without manually grepping through ~/.claude/projects/.
It indexes every local Claude Code session transcript (including subagent/Task-tool transcripts) into a local SQLite FTS5 full-text index, then lets you search by keyword, exact phrase, or required terms — optionally filtered by project and date, with relevance ranking that also weighs recency.
- Requires
uv(used to auto-manage the script's Python environment — no separatepip installneeded) and Python 3.11+. - Save the
find-convofile from this gist into~/.local/bin/find-convo, then make it executable: