skills.rest
acaprino
acaprinoCOMMUNITY
Explore all skills by this author →
GitHub

cc-usage

Analyze Claude Code JSONL session logs to generate Markdown usage reports.

6|2|Updated Jan 6, 2026
Search Tags:#analytics#tokens#sessions#billing#costs#usage#tools
One-click install
npx skills add https://github.com/acaprino/claude-code-daodan --skill cc-usage-acaprino
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cc-usage
Source: https://github.com/acaprino/claude-code-daodan/tree/main/plugins/cc-usage/skills/cc-usage
Command: npx skills add https://github.com/acaprino/claude-code-daodan --skill cc-usage-acaprino

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Claude Code usage data is scattered across sessions; this skill aggregates token usage, costs, billing blocks, and tool activity to deliver a unified view.

Core Features & Use Cases

  • Aggregate token usage, cost estimates, and billing blocks from local session data.
  • Break down usage by model tier (opus, sonnet, haiku) and per-project.
  • Identify top tools used and usage trends over time.

Quick Start

Run the cc_usage.py script to generate the usage report for your local Claude Code sessions.

Frequently Asked Questions about cc-usage

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

FAQPage Schema
How do I track Claude Code token usage and costs across local sessions?▼

Track Claude Code token usage and costs by running a script that reads native JSONL logs from standard directories, computes totals using model pricing, and outputs a formatted Markdown report.

Can I break down Claude Code billing blocks and tool usage by project?▼

Yes, you can break down billing blocks and tool usage by project, as the skill aggregates local session data to identify top tools used and per-project usage trends over time.

What is the best way to analyze Claude Code session data for model tier breakdowns?▼

The best way to analyze session data for model tier breakdowns is using a script that parses local JSONL logs to aggregate token usage across opus, sonnet, and haiku models.

How do I generate a JSON payload report from Claude Code usage logs?▼

Generate a JSON payload report from Claude Code usage logs by running the analysis script, which computes token totals and costs to output either a formatted Markdown report or JSON.

Does the Claude Code usage tracker require any external dependencies to run?▼

No external dependencies are required, as the skill operates independently using scripts to read native JSONL session logs directly from standard Claude Code local directories.

What limitations exist when estimating costs from local Claude Code session data?▼

Cost estimation limitations depend on static model pricing applied to local JSONL logs, meaning the computed totals reflect session token usage rather than real-time billing portal data.

Related Skills

Explore More Software Engineering Skills→
hicucuhicucu
1

session-manager

Analyze and manage local Claude Code session files in JSONL format.

Community
Advanced
billlzzz26billlzzz26
4

story-export

Export StoryGraph data into Mermaid diagrams, Canvas JSON, Markdown, HTML dashboards, and MCP UI dashboards.

Community
Advanced
MicrockMicrock
322

Convex Agents Usage Tracking

Track LLM token usage and calculate costs for billing reports.

Community
Advanced
alibabaalibaba
9.1k

agent-session-monitor

Aggregate Higress access logs into session histories with token-cost analytics.

Official
Advanced