skills.rest
ItsMattG
ItsMattGCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/ItsMattG/property-tracker --skill conversation-search-itsmattg
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Data & Analytics Skills→
treejhtreejh

history-insight

Extract structured insights from Claude Code session JSONL logs.

Community
Advanced
R3n3gade-aiR3n3gade-ai

cross-channel-history-retrieval

Retrieve cross-channel chat history from history.json files and output a structured context block.

Community
Intermediate
Jerry-Z07Jerry-Z07
21

parallel

Plan and dispatch parallel development tasks to worktree agents using PRD and jsonl context files.

Community
Advanced
vignesh2027vignesh2027
18

session-logs

Search and analyze historical session logs in JSONL files with jq and ripgrep.

Community
Intermediate