skills.rest
brandon-fryslie
brandon-fryslieCOMMUNITY
Explore all skills by this author →
GitHub

find-session

Search JSONL transcript files for keyword matches and retrieve message context.

4|Updated Jan 12, 2017
Search Tags:#claude code#transcript analysis#session search#conversation context#topic retrieval
One-click install
npx skills add https://github.com/brandon-fryslie/dotfiles --skill find-session
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: find-session
Source: https://github.com/brandon-fryslie/dotfiles/tree/main/config/claude/skills/find-session
Command: npx skills add https://github.com/brandon-fryslie/dotfiles --skill find-session

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the challenge of finding specific Claude Code sessions by topic, saving time and reducing the frustration of searching through transcripts.

Core Features & Use Cases

  • Session Identification: Quickly identify and locate Claude Code sessions based on keywords or topics.
  • Contextual Retrieval: Retrieve context around the matched session or fetch a single message's full body.
  • Use Case: If you're looking for a past conversation where you discussed a particular topic, this Skill can help you find it without having to remember the session ID.

Quick Start

Run the find-session skill with the topic you want to search for, e.g., 'find-session "project management"'

Frequently Asked Questions about find-session

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

FAQPage Schema
How do I search Claude Code session transcripts by topic?▼

To search Claude Code session transcripts by topic, use a tool that scans JSONL transcript files within project directories for keyword matches. It retrieves contextual text around matched sessions so you can locate past conversations without knowing the session ID.

What is the best way to find a specific message in a Claude Code conversation history?▼

Finding a specific message in Claude Code conversation history is possible by fetching the full message body using its UUID. The tool parses JSON transcript files and extracts the complete content of the message matching that unique identifier.

Does session search by keyword require a specific Python environment setup?▼

Session search by keyword requires a Python environment with regex and JSON parsing capabilities. You must also have direct access to the Claude Code project directories where the JSONL transcript files are stored for the scan to execute successfully.

How do I retrieve conversation context around matched keywords in transcript files?▼

To retrieve conversation context around matched keywords in transcript files, run a topic search against your Claude Code project directories. The scan identifies keyword matches in the JSONL files and outputs the surrounding conversational text for immediate review.

Can I locate past coding sessions if I only remember the discussed topic and not the ID?▼

Locating past coding sessions when you only remember the discussed topic is exactly what keyword-based transcript search enables. By scanning JSONL files for topic matches, it identifies relevant sessions and provides context without requiring a prior session ID.

Related Skills

Explore More Software Engineering Skills→
tcdenttcdent

get-history-filename

Locate JSONL transcript files for Claude Code and Codex sessions via tmux pane tracing.

Community
Advanced
OneWave-AIOneWave-AI
245

conversation-archaeologist

Extract writing style, goals, and preferences from past Claude conversations.

Official
Advanced
JoeyJoziahJoeyJoziah

session-logs

Search JSONL session logs with jq and rg to recover conversation context.

Community
Intermediate
dtsongdtsong
1

code-search

Search codebases for text patterns and files using grep and glob.

Community
Basic