session-analyzer

Identify and list Claude Code session transcripts from .claude/logs/ by date.

3|Updated Oct 6, 2025
One-click install
npx skills add https://github.com/nitromike502/claude-code-web-manager --skill session-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-analyzer
Source: https://github.com/nitromike502/claude-code-web-manager/tree/main/.claude/skills/session-analyzer
Command: npx skills add https://github.com/nitromike502/claude-code-web-manager --skill session-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solves? Navigating through numerous Claude Code session logs to find specific interactions or understand your development history can be time-consuming. This Skill provides an organized way to discover, list, and get an overview of your past Claude Code sessions, making workflow analysis effortless.

Core Features & Use Cases

  • Effortless Session Discovery: Automatically scans your .claude/logs/ directory, identifying and grouping main and subagent transcripts.
  • Chronological History: Lists sessions by date, allowing you to quickly find recent activity or historical interactions.
  • Detailed Session Overview: For each session, view its ID, start time, main transcript filename, and the number of associated subagent transcripts.
  • Date Filtering: Easily filter sessions by a specific date (YYYYMMDD) to focus on a particular day's work.
  • Use Case: You want to review all your Claude Code sessions from last Tuesday to understand how a specific feature was developed. This Skill helps you quickly locate and list those sessions, preparing them for deeper analysis.

Quick Start

List all dates with available sessions

node .claude/skills/session-analyzer/analyze-session.js

List all sessions from October 17, 2025

node .claude/skills/session-analyzer/analyze-session.js 20251017

Frequently Asked Questions about session-analyzer

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

FAQPage Schema
How do I discover and list my Claude Code session logs?

Session discovery automatically scans your `.claude/logs/` directory to identify and list all Claude Code sessions. Run `node .claude/skills/session-analyzer/analyze-session.js` to display sessions chronologically with their IDs, start times, and associated subagent transcript counts.

Can I filter Claude Code sessions by a specific date?

Date filtering lets you isolate sessions from a particular day using YYYYMMDD format. Run `node .claude/skills/session-analyzer/analyze-session.js 20251017` to list only sessions from October 17, 2025, enabling focused workflow review.

What information does a session overview include?

Each session overview displays its unique ID, start timestamp, main transcript filename, and the count of associated subagent transcripts, providing a comprehensive snapshot for workflow analysis without opening individual logs.

How do I analyze my development history across multiple Claude Code sessions?

Workflow analysis groups main and subagent transcripts by session and displays chronological timelines with colored terminal output. This organization lets you quickly trace how features were developed across past interactions.

What are the prerequisites for using the session analyzer?

The session analyzer requires Node.js and Claude Code installed with an existing `.claude/logs/` directory containing session transcripts. Valid date formats (YYYYMMDD) and proper log file structure enable accurate session grouping and timeline display.

Does the session analyzer work with subagent transcripts?

Yes, the analyzer automatically identifies and groups subagent transcripts alongside main session logs, displaying subagent counts per session and enabling comprehensive workflow analysis across nested agent interactions.