find-conversation
Search past Claude Code conversations by keyword and instantly find any session to resume. The tool scans your entire conversation history a
Open source Open in the app JSON README (API)
About
Search past Claude Code conversations by keyword and instantly find any session to resume. The tool scans your entire conversation history across all projects and outputs a formatted table with session slugs, project paths, timestamps, message previews, match context, and ready-to-copy resume commands. It uses binary pre-filtering and single-pass parsing for fast results, with no external dependencies — compatible with Python 3.8 and above.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- akzarma
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-03-26T20:22:41Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
akzarma/claude-find-conversation/find-conversation
README
# find-conversation A Claude Code plugin to instantly search and resume past conversations by keyword. ## What it does Searches all your Claude Code conversation history across every project and returns a formatted table with: - Session slug and match count - Project path (decoded from Claude's internal format) - Start and last-active timestamps - Last user message preview - First matching snippet for context - Ready-to-copy `claude --resume` commands ## Install ```bash /plugin marketplace add akzarma/claude-find-conversation /plugin install find-conversation@akzarma-tools ``` ## Usage ```bash /find-conversation <search terms> ``` ### Examples ```bash /find-conversation deployment vercel /find-conversation auth middleware bug /find-conversation database migration ``` ## How it works 1. **Binary pre-filter** — scans conversation JSONL files in 1MB chunks to skip non-matching files instantly 2. **Single-pass parsing** — reads each matching file once, extracting metadata, match counts, and message previews 3. **Efficient last-line seek** — reads timestamps from file ends without loading entire files into memory 4. **Smart path decoding** — reconstructs real filesystem paths from Claude's dash-encoded project folder names using greedy filesystem matching No external dependencies. Python 3.8+ only (ships with macOS and Linux). ## Requirements - Claude Code (macOS or Linux) - Python 3.8+ (pre-installed on all supported platforms) ## License MIT