session-search

Search local Claude Code, Cowork, and Codex transcripts by filters and full-text.

95|2|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/techwolf-ai/ai-first-toolkit --skill session-search-techwolf-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-search
Source: https://github.com/techwolf-ai/ai-first-toolkit/tree/main/plugins/ai-adoption/skills/session-search
Command: npx skills add https://github.com/techwolf-ai/ai-first-toolkit --skill session-search-techwolf-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps you locate and recall previous Claude Code, Claude Cowork, and Codex sessions stored on disk, enabling quick context retrieval and audit trails.

Core Features & Use Cases

  • Find sessions by kind (code, cowork, all), time range, title, or working directory, and by full-text content across transcripts.
  • Preview session metadata and retrieve a portion of the transcript for rapid context.
  • Use cases include remembering where a design discussion occurred, locating the exact session that covered a feature, or extracting a relevant conversation for context.

Quick Start

Run find_sessions.py to locate a session by keyword in its transcript, then inspect it with show_session.py.

Frequently Asked Questions about session-search

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

FAQPage Schema
How do I search past Claude Code session transcripts for a specific keyword?

To search past Claude Code session transcripts for a specific keyword, use a grep-like full-text search to locate and retrieve historical conversations stored locally on disk, enabling fast context recall across matching turns.

Can I filter Claude Cowork sessions by time range and working directory?

Yes, you can filter Claude Cowork sessions by time range and working directory. The tool normalizes turns from local storage and supports filtering by kind, title, and cwd to help you locate specific historical conversations.

Does this transcript search tool support finding Codex sessions stored locally?

Yes, the transcript search tool supports finding Codex sessions stored locally. It offers optional Codex compatibility alongside Claude Code and Claude Cowork, allowing you to retrieve and normalize historical sessions across multiple platforms.

What is the best way to retrieve context from a previous Claude Code design discussion?

The best way to retrieve context from a previous Claude Code design discussion is to preview session metadata and retrieve a portion of the transcript directly from local storage, allowing rapid context recall without restoring the entire session.

How do I extract a specific conversation from local Claude session transcripts?

To extract a specific conversation from local Claude session transcripts, run a script to locate sessions by full-text content, then inspect the matching transcript to pull the relevant normalized turns for your context.

Are there limitations when searching for old Codex transcripts across different working directories?

A limitation when searching for old Codex transcripts is that Codex compatibility is optional, and while you can filter by working directory, the tool reads transcripts directly from disk, meaning only locally stored sessions are searchable.