Déglacer — CC Session JSONL Reference

Deglazing the pan to lift the fond — extracting the good bits from past sessions.

When to Use This Skill

You are working with Claude Code session data. This includes:

• Introspecting past conversations — "what did we discuss last session?", "when did we first talk about X?"
• Searching session history — finding sessions that mention a topic, tool, or file
• Parsing JSONL transcripts — extracting human messages, tool calls, thinking blocks, token usage
• Building tooling — anything that reads ~/.claude/projects/ session data
• Debugging session format — understanding why a jq query returns nothing

Do NOT guess at the schema. The CC JSONL format has multiple entry types, triple-duty user entries, streaming-duplicated message.ids, and inconsistent field presence across versions. This reference is the source of truth.

When NOT to Use