chat-history

Search Claude Code and Cursor conversation transcripts with UUID lookup and JSON output.

9|1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/ay-bh/chat-history --skill chat-history-ay-bh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chat-history
Source: https://github.com/ay-bh/chat-history/tree/main
Command: npx skills add https://github.com/ay-bh/chat-history --skill chat-history-ay-bh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly locate, understand, and reuse information from Claude Code and Cursor conversation history so you do not waste time repeating prior work or searching through transcripts manually.

Core Features & Use Cases

  • Session discovery & summaries: List sessions and use summaries to identify what you did and when you did it.
  • Fast and deep search: Search by keywords using index metadata for speed, or use deep transcript search for thorough matching.
  • Actionable follow-ups: Inspect a session for accomplishments/tools/files, view transcript content, export it to markdown, resume (Claude Code only), or find the backing file path.
  • Use Case: You remember an “auth error” came up recently and you need the exact context and actions taken; search your history with deep transcript matching, then inspect the top session to see tools used and files touched.

Quick Start

Ask: "Search my history for auth error, then give me the top matching session summary and transcript snippet as JSON."

Frequently Asked Questions about chat-history

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

FAQPage Schema
How do I search past Claude Code chat history for a specific keyword?

You can search past Claude Code chat history by keywords using index metadata for fast matching or apply deep parallel transcript search to thoroughly match prompts, summaries, and conversation content.

Can I find a previous Cursor session if I only remember part of the UUID?

Yes, you can locate a previous Cursor or Claude Code session by providing a full or partial UUID, which the skill uses to retrieve the matching conversation history and its context.

How do I export a Claude Code transcript to markdown after finding it?

After locating your target session through search, you can view the transcript content and export it to markdown, or retrieve the backing file path to manually access the Claude Code chat history.

What details are included when I retrieve a matched Claude Code session?

Retrieving a matched session provides structured JSON output containing the session_id, relevance score, transcript snippet, tools used, and files touched during that specific Claude Code or Cursor conversation.

Can I resume a previous Claude Code workflow directly from the search results?

Yes, you can resume a workflow directly from search results for Claude Code sessions, allowing you to pick up prior work immediately after locating the desired conversation history.

Does deep transcript search look through the full conversation content or just summaries?

Deep transcript search thoroughly examines the full conversation content, including prompts and transcript text, rather than just relying on index metadata or session summaries to find matching chat history.