analyzing-usage

Aggregate ccusage logs to analyze Claude Code costs, tokens, and efficiency.

35|5|Updated Jul 5, 2025

Search Tags:#tokens #usage #analyze #cost #burn-rate #ccusage #termgraph

Ready to run

npx skills add https://github.com/alexei-led/cc-thingz --skill analyzing-usage

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: analyzing-usage
Source: https://github.com/alexei-led/cc-thingz/tree/main/plugins/dev-tools/skills-codex/analyzing-usage
Command: npx skills add https://github.com/alexei-led/cc-thingz --skill analyzing-usage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code usage data is often buried in logs and hard to interpret. This skill provides clear, visual analyses of usage, cost, and efficiency to help optimize spend and performance.

Core Features & Use Cases

Analyze daily, weekly, monthly, and session usage for Claude Code with cost, tokens, and burn-rate metrics.
Generate model-level cost breakdowns, token volumes, cache hit rates, and efficiency metrics to guide budgeting and optimization.
Use cases include cost forecasting, budget planning, and performance optimization across teams.

Quick Start

Ask Claude Code to generate a daily cost report for a given date range and visualize the results with termgraph.

Frequently Asked Questions about analyzing-usage

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

FAQPage Schema

How do I analyze Claude Code token usage and cost burn rate?▼

You can visualize Claude Code usage costs by generating daily, weekly, monthly, or session reports that aggregate ccusage logs. The skill extracts cost, token volumes, and burn-rate metrics and presents them via termgraph visualizations.

Can I generate a daily cost report for Claude Code models?▼

You can generate daily cost reports for Claude Code by asking Claude Code to aggregate ccusage logs over a specific date range. It reveals model cost shares, token volumes, and burn-rate metrics visualized with termgraph.

How does termgraph visualize Claude Code session usage?▼

Termgraph visualizes Claude Code session usage by rendering structured metrics extracted from ccusage JSON outputs into terminal-based charts. This reveals token throughput, cache hit rates, and efficiency metrics for the session scope.

Do I need ccusage installed to analyze Claude Code token efficiency?▼

Yes, you need ccusage logs because the skill aggregates JSON outputs from ccusage to extract timing information, token volumes, and cache performance. Without these logs, there is no data source for the burn rate and model cost breakdowns.

What is the best way to track token burn rate across multiple Claude Code models?▼

The best way to track token burn rate across models is to aggregate ccusage logs into a structured breakdown of model cost shares and token volumes. The skill applies this to daily, weekly, monthly, or session scopes for budgeting.