chat-history-search

Search local Claude chat histories across CLI JSONL and Cowork transcripts.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/BryceEWatson/claude-global-skills --skill chat-history-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chat-history-search
Source: https://github.com/BryceEWatson/claude-global-skills/tree/main/chat-history-search
Command: npx skills add https://github.com/BryceEWatson/claude-global-skills --skill chat-history-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Exhaustive search across Claude chat history stored in two separate local corpora to reliably locate user prompts, conversations, and audit trails.

Core Features & Use Cases

  • Corpora coverage: searches Claude Code CLI JSONL logs and Cowork local-agent-mode transcripts to avoid missed prompts.
  • False-positive reduction: distinguishes user prompts from tool results, subagent notifications, and system events.
  • Audit-ready outputs: provides verbatim excerpts with timestamps and contextual metadata to support traceability.
  • Use Case: When you need to review where you asked Claude about a topic across projects, recover a past conversation, or audit session activity.

Quick Start

Run a query to search your local Claude history across both corpora.

Frequently Asked Questions about chat-history-search

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

FAQPage Schema
How do I search my local Claude chat history across different projects?

Search local Claude chat history across multiple corpora by running keyword, pattern, or timeline queries to locate prompts and recover past conversations across all your projects. The tool scans both CLI JSONL logs and Cowork transcripts.

Can I search both Claude Code CLI logs and Cowork transcripts at the same time?

Yes, you can search both Claude Code CLI JSONL logs and Cowork local-agent-mode transcripts simultaneously. This dual-corpora coverage prevents missed prompts by exhaustively scanning both local storage formats in a single query.

How do I audit Claude sessions and recover verbatim conversation excerpts?

Audit Claude sessions by running timeline queries across your local chat history. The search returns structured, verbatim excerpts with timestamps and contextual metadata to support full traceability and session activity verification.

Does Claude chat history search filter out tool results and system notifications?

Yes, searching Claude chat history rejects false positives by distinguishing actual user prompts from tool_result content, subagent notifications, and <task-notification> wrappers, ensuring your search results only contain relevant conversational text.

What is the best way to find a specific prompt I previously asked Claude?

The best way to find a specific prompt is to run a keyword or pattern query against your local Claude chat history. It exhaustively searches both CLI and Cowork corpora, returning structured excerpts with timestamps for quick verification.