scan-abandoned-sessions

Analyze JSONL session tails to classify abandoned Claude Code sessions.

Updated Oct 15, 2021
One-click install
npx skills add https://github.com/toqoz/config --skill scan-abandoned-sessions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan-abandoned-sessions
Source: https://github.com/toqoz/config/tree/main/home/agents/skills/scan-abandoned-sessions
Command: npx skills add https://github.com/toqoz/config --skill scan-abandoned-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill identifies truly abandoned Claude Code sessions that were left mid-way, ensuring that important work or user prompts are not forgotten or lost in the file system.

Core Features & Use Cases

  • Intelligent Filtering: Automatically distinguishes between abandoned work and noise like sandbox tests, completed tasks, or git-flow pauses.
  • Context-Aware Reporting: Provides a clear summary of unfinished sessions, including the last user prompt and the point of interruption.
  • Use Case: Use this after a long period of inactivity or when you suspect you left a complex coding task unfinished to quickly audit your recent history and resume where you left off.

Quick Start

Ask the agent to scan for abandoned sessions to identify and report any unfinished work from the last week.

Frequently Asked Questions about scan-abandoned-sessions

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

FAQPage Schema
How do I find abandoned Claude Code sessions in my project logs?

To find abandoned Claude Code sessions, you can scan JSONL session log tails against progress heuristics. This filters out completed tasks and noise, reporting only unfinished work and the last user prompt from your project directories.

What is the best way to recover unfinished work from interrupted Claude Code sessions?

Recovering unfinished Claude Code work involves auditing session logs with progress heuristics to identify interruptions. The scan classifies abandoned sessions contextually, summarizing the exact point of interruption so you can resume quickly.

How does the session log audit distinguish between abandoned tasks and completed work?

The session log audit distinguishes abandoned tasks by analyzing JSONL file tails against predefined progress heuristics. It operates on project-specific directories to automatically filter out noise, completed tasks, git-flow pauses, and ongoing work.

Does the abandoned session scan require file system access to read JSONL logs?

Yes, the abandoned session scan requires file system access to read JSONL session logs and maintain a scan cursor. This access enables incremental auditing of project-specific session directories without reprocessing previously checked data.

Can I audit session logs incrementally to avoid rescanning old Claude Code history?

Yes, you can audit session logs incrementally because the scan maintains a cursor within the file system. This cursor tracks previously processed JSONL data, ensuring the scan only evaluates recent session log tails for abandoned work.

Why are some completed tasks or git pauses showing up when I scan for abandoned sessions?

Completed tasks or git pauses may appear if session log tails are not properly filtered. The scan uses intelligent filtering and predefined progress heuristics to automatically classify and exclude these non-abandoned states from the final report.