claude-session-introspect

What problem does it solve?

Claude Code stores all conversation data as raw JSONL files on disk, but manually parsing these files to extract useful metrics like token usage, prompt counts, and compaction events is time-consuming and requires advanced command-line knowledge. This Skill eliminates that friction by providing a pre-built recipe and script to pull these metrics in seconds.

Core Features & Use Cases

• Token Usage Tracking: Extract full session token counts including input, output, cache reads, and cache writes to audit context window usage.
• Conversation Metrics: Count human prompts, assistant turns, and top tool calls to understand session activity patterns.
• Compaction Analysis: Identify compaction boundaries, triggers, and surviving summary content to debug context loss in long-running sessions.
• Use Case: A developer working on a long coding project can use this Skill to quickly check how many tokens their session has consumed, or identify which tool call caused unexpected context bloat.

Quick Start

Use the claude-session-introspect skill to pull full usage stats for your current Claude Code session, including token counts, prompt totals, and compaction events.