session-discovery

Find local Claude Code sessions within a date range and generate a JSON manifest.

12|2|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/hartphoenix/weft --skill session-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-discovery
Source: https://github.com/hartphoenix/weft/tree/main/.claude/skills/session-discovery
Command: npx skills add https://github.com/hartphoenix/weft --skill session-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables the discovery and structured retrieval of Claude Code conversation sessions stored locally, facilitating session management and analysis.

Core Features & Use Cases

  • Session Retrieval: Finds conversation sessions on the local machine within specified date ranges.
  • Structured Manifest Generation: Outputs a JSON outline with session metadata for integration with other tools.
  • Use Case: A user wants to review all sessions from last week to analyze progress or extract evidence for reporting purposes.

Quick Start

Run the session-discovery script to obtain recent conversation sessions in JSON format.

Frequently Asked Questions about session-discovery

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

FAQPage Schema
How do I find Claude Code conversation sessions stored locally on my machine?

To find Claude Code conversation sessions locally, this Skill reads session files within a specified date range and generates a detailed JSON manifest containing session metadata for review or processing.

Can I retrieve conversation logs from a specific date range for progress review?

Yes, you can retrieve conversation logs from a specific date range. The script filters relevant conversation data based on your specified dates to support session analysis and progress review.

How do I extract Claude Code session metadata into a structured JSON format?

You can extract Claude Code session metadata into structured JSON by running the discovery script, which reads local session files and outputs a detailed JSON manifest for integration with other tools.

Does this session discovery script require any specific dependencies to run?

No, this session discovery script does not require any specific dependencies to run. It operates independently using its internal scripts component to read and filter local session files.

What is the best way to automate session analysis for recent Claude Code activity?

The best way to automate session analysis is to use this Skill to generate a JSON manifest of recent activity, which can then be fed into downstream automation and infrastructure workflows.

Are there limitations when retrieving local Claude conversation sessions with this tool?

A limitation is that this tool only processes locally stored Claude Code conversation sessions. It does not retrieve remote sessions and provides metadata in JSON format without built-in conversation content analysis.