claude-session-history

Parse Claude Code JSONL logs to summarize sessions and identify pending tasks.

Updated Jan 5, 2026
One-click install
npx skills add https://github.com/d3ming/dot-agents --skill claude-session-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-session-history
Source: https://github.com/d3ming/dot-agents/tree/main/master/skills/claude-session-history
Command: npx skills add https://github.com/d3ming/dot-agents --skill claude-session-history

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers recover context and next steps from interrupted or overflowing Claude Code sessions by reading and synthesizing per-project session logs so work can be resumed quickly and reliably.

Core Features & Use Cases

  • Session discovery and search: find sessions by recent activity or by matching user messages across per-project JSONL logs.
  • Summarization and recovery: extract the initial task, assistant narrative, tool calls, overflow detection, and a concise synthesis of accomplishments, where it stopped, and pending work.
  • Worktree awareness and safeguards: detects git worktrees, scopes searches to an explicit workspace when requested, and emphasizes verification steps before claiming repository state.
  • Use case: recover the last unfinished coding session after a context overflow to continue the task without re-running prior steps.

Quick Start

Ask the assistant to find and summarize the latest Claude Code session for the current project and recommend the next actionable step.

Frequently Asked Questions about claude-session-history

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

FAQPage Schema
How do I recover an interrupted Claude Code session after a context overflow?

You can recover an interrupted Claude Code session by parsing per-project JSONL logs to detect context overflows, extract the initial task, and synthesize pending work. This summarizes where the session stopped and recommends the next actionable step.

What is the best way to search previous Claude Code session history by user messages?

The best way to search Claude Code session history by user messages is by scanning per-project JSONL session directories. This matches your search queries against logged records to find relevant past interactions and list recent sessions.

Can I summarize Claude Code JSONL logs to find pending tasks from a previous coding session?

Yes, you can summarize Claude Code JSONL logs to find pending tasks. The process extracts the initial task, tracks the assistant narrative, counts tool calls, and synthesizes findings to highlight accomplishments and unfinished work without exposing raw session dumps.

Does recovering session history work with git worktrees?

Recovering Claude Code session history works with git worktrees by detecting the worktree environment. It scopes searches to an explicit workspace when requested and emphasizes verification steps before claiming repository state.

What information is extracted from Claude Code session logs during recovery?

During Claude Code session recovery, the skill parses JSONL records to extract the initial task, assistant narrative elements, tool call counts, and overflow detection. It synthesizes these findings to provide a concise summary without exposing raw session dumps.