skills.rest
marqus0004
marqus0004COMMUNITY
Explore all skills by this author →
GitHub

cc-history

Query and analyze Claude Code JSONL conversation logs with jq.

Updated Feb 6, 2026
Search Tags:#logs#history#jq#claude-code#analyze#jsonl#token-usage
One-click install
npx skills add https://github.com/marqus0004/LifeIsRoadBlocks --skill cc-history-marqus0004
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cc-history
Source: https://github.com/marqus0004/LifeIsRoadBlocks/tree/main/skills/cc-history
Command: npx skills add https://github.com/marqus0004/LifeIsRoadBlocks --skill cc-history-marqus0004

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code history analysis enables you to query and summarize JSONL conversation logs to uncover patterns in interactions, token usage, and tool invocations.

Core Features & Use Cases

  • Query conversations by date, user, or agent to inspect specific interactions.
  • Analyze token usage and tool invocations to audit workflows and performance across sessions.
  • Trace subagent activity and branching to understand how tasks flow through agents and tools.

Quick Start

Identify a target Claude Code history JSONL file and run a simple jq query to begin extracting messages and usage data.

Frequently Asked Questions about cc-history

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

FAQPage Schema
How do I analyze Claude Code history logs for token usage?▼

Parse Claude Code JSONL history files with shell and jq to extract token usage data. This skill queries conversation logs with defined schemas for message types, timestamps, and usage fields to summarize token consumption across sessions.

What is the best way to query JSONL conversation logs by date?▼

Filter Claude Code JSONL conversation logs by date, user, or agent using shell commands and jq. This skill parses timestamp fields within the JSONL message schema to isolate and inspect specific historical interactions.

Do I need jq to trace subagent activity in Claude Code logs?▼

Yes, jq is required to trace subagent activity and tool invocations in Claude Code JSONL logs. This skill applies shell commands and jq queries to parse branching task flows and agent interactions within the conversation history.

Can I audit tool invocations across Claude Code sessions?▼

Yes, you can audit tool invocations across Claude Code sessions. This skill applies jq queries to JSONL history files to summarize tool calls and usage fields, enabling workflow and performance audits across projects.

How does Claude Code store conversation history and message flows?▼

Claude Code stores conversation history and message flows in JSONL log files. This skill parses these logs using a stable schema with message types and timestamps to extract insights on interactions and subagent work.

Related Skills

Explore More Data & Analytics Skills→
aresbitaresbit
46

session-logs

Search and analyze historical session JSONL files using jq and rg.

Community
Intermediate
shepard-systemshepard-system
70

obs-tools

Analyze AI tool invocation metrics from Prometheus data over 24 hours.

Official
Intermediate
fmoda3fmoda3
42

cc-history

Query and analyze Claude Code JSONL conversation history logs with jq.

Community
Intermediate
douglasjsdouglasjs

session-logs

Search and analyze JSONL conversation logs using jq and rg.

Community
Intermediate