conversation-search

Search Claude conversation JSONL files for keywords with date filtering and context windows.

Updated Aug 23, 2026

Search Tags:#search #claude #jsonl #context-windows #conversation-history #date-filtering

Ready to run

npx skills add https://github.com/ItsMattG/property-tracker --skill conversation-search-itsmattg

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: conversation-search
Source: https://github.com/ItsMattG/property-tracker/tree/main/.claude/skills/conversation-search
Command: npx skills add https://github.com/ItsMattG/property-tracker --skill conversation-search-itsmattg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude conversation history is stored as JSONL files, making it difficult to locate prior decisions, debugging notes, or timeline references when re-implementing work. This skill provides a fast, keyword-driven search across your archived conversations with optional date filtering and contextual snippets to understand the surrounding discussion.

Core Features & Use Cases

Keyword search across Claude conversation JSONL files to surface relevant messages from past sessions.
Date filtering to narrow results to a specific time window.
Context windows to show surrounding messages for better understanding of decisions.
Multi-project support to search across one or more BrickTrack projects.

Quick Start

Run conversation-search 'keyword' to locate matching messages in Claude conversation history.

Frequently Asked Questions about conversation-search

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

FAQPage Schema

How do I search Claude conversation history files for a specific keyword?▼

You can search Claude conversation history by running a keyword query against JSONL files stored in ~/.claude/projects, which uses a fast file grep followed by Python extraction to parse and return matching user and assistant messages.

Can I filter past Claude conversations by date to find decisions from a specific time?▼

Yes, date filtering allows you to narrow search results to a specific time window, helping you locate prior decisions, debugging sessions, or timeline references from past Claude conversations within that date range.

How do I get context around a matched keyword in Claude JSONL files?▼

Context windows are configurable to show surrounding messages around keyword matches in Claude JSONL files, providing the surrounding discussion needed to understand past decisions and debugging notes.

Does conversation-search work across multiple BrickTrack projects?▼

Yes, multi-project support allows you to search across one or more BrickTrack projects simultaneously, scanning archived JSONL conversation files to surface relevant messages from past sessions.

What is the best way to find past debugging notes stored in Claude conversation logs?▼

The best way to find past debugging notes in Claude conversation logs is running a keyword-driven search with optional date filtering and context windows across archived JSONL files to surface and understand prior debugging sessions.

Do I need Python installed to search Claude conversation history JSONL files?▼

Yes, Python is required for the extraction step that parses user and assistant messages from JSONL files to assemble keyword matches with optional date filtering and configurable context windows.