session-status

Scan Claude Code session logs and classify statuses into a health report.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jeff-hamm/ai-tools --skill session-status-jeff-hamm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-status
Source: https://github.com/jeff-hamm/ai-tools/tree/main/src/skills/session-status
Command: npx skills add https://github.com/jeff-hamm/ai-tools --skill session-status-jeff-hamm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Claude Code sessions can drift into states like active, broken, truncated, or waiting, making it hard to quickly assess system health. This skill provides a quick health check to surface the status of recent sessions across Claude Code projects.

Core Features & Use Cases

  • Health overview: detect active, broken, truncated, and waiting sessions across projects.
  • Status triage: filter and sort sessions by recency and health indicators for rapid debugging.
  • Programmatic output: optionally emit JSON for downstream tooling and dashboards.

Quick Start

Run the script to print the real-time Claude Code session health report.

Frequently Asked Questions about session-status

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

FAQPage Schema
How do I check the health of my Claude Code sessions?

Claude Code session health checks scan session logs to classify statuses like ok, stub, BROKEN, TRUNCATED, WAITING, and active, outputting a concise real-time report across your projects for rapid debugging.

Why does my Claude Code session show as broken or truncated?

Claude Code sessions can drift into broken or truncated states during execution. A session health check scans your project logs, identifies these specific status classifications, and surfaces them so you can triage and debug the affected sessions quickly.

Can I get JSON output from a Claude Code session health check?

Yes, you can emit JSON output from the session health check. The diagnostic script optionally formats the real-time status classifications into JSON, allowing downstream tooling and dashboards to consume the session health data programmatically.

What is the best way to triage waiting Claude Code sessions across projects?

The best way to triage waiting sessions is to run a health check script that scans logs across all Claude Code projects, filters sessions by recency and health indicators, and classifies statuses like WAITING and active to surface sessions needing evaluation.

Does the session health check work with active Claude Code sessions?

Yes, the session health check works with active Claude Code sessions. It scans session logs in real time to classify statuses including active, ok, and stub, providing a health overview across all your Claude Code projects.

How do I sort Claude Code sessions by recency for debugging?

To sort sessions by recency for debugging, run the session health check script. It scans your Claude Code logs, filters sessions by health indicators, and sorts them by recency to help you rapidly identify and triage broken or truncated sessions.