cc-history

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

42|3|Updated Mar 5, 2021
One-click install
npx skills add https://github.com/fmoda3/nix-configs --skill cc-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cc-history
Source: https://github.com/fmoda3/nix-configs/tree/main/home/claude-code/config/skills/cc-history
Command: npx skills add https://github.com/fmoda3/nix-configs --skill cc-history

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code conversation histories can be complex and large; this Skill provides a structured reference to query and analyze those JSONL logs to extract actionable insights.

Core Features & Use Cases

  • Guided reference: Quick access to patterns for token usage, subagent activity, and tool invocations.
  • Debugging aid: Helps identify interaction patterns between main agents and subagents to diagnose issues.
  • Auditing and governance: Supports auditing conversations for compliance and governance.

Quick Start

Use this Skill to read a Claude Code history file and extract the first user message to locate relevant task descriptions.

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 conversation history logs?

To analyze Claude Code conversation history, use this Skill to parse JSONL logs with shell commands and jq, extracting token usage, subagent activity, and tool invocation patterns for actionable insights.

What is the best way to extract token usage from Claude Code JSONL files?

The best way to extract token usage from Claude Code JSONL files is using this Skill's jq patterns to parse the logs, enabling detailed performance reviews and debugging of agent interactions.

Can I use standard CLI tools to debug subagent activity in Claude Code?

Yes, you can debug subagent activity in Claude Code using standard CLI tools. This Skill relies on shell commands and jq to parse JSONL histories without requiring any specialized libraries.

Does this Skill require any specialized libraries to parse JSONL histories?

No specialized libraries are required. This Skill parses JSONL histories and loads data into context using standard CLI tools like shell commands and jq for auditing and governance.

How do I audit Claude Code conversations for compliance and governance?

Audit Claude Code conversations for compliance by using this Skill to query JSONL history logs, reviewing interaction patterns between main agents and subagents for governance checks.

Why analyze subagent activity and branch exploration in Claude Code?

Analyze subagent activity and branch exploration in Claude Code to diagnose issues and identify interaction patterns between main agents and subagents, directly aiding debugging and performance reviews.