token-track

Analyze Claude Code JSONL logs to compute token usage and model limits.

1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/buildoak/claude-limits-reverse-engineering-skill --skill token-track
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: token-track
Source: https://github.com/buildoak/claude-limits-reverse-engineering-skill/tree/main
Command: npx skills add https://github.com/buildoak/claude-limits-reverse-engineering-skill --skill token-track

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code token usage tracking and limit reverse-engineering. Daily/project/model breakdown, burn rate, context gauge, limit calibration. Active model: Formula A (CU = Σ_model[mult × (inp×1.0 + out×5.0 + cc×1.25 + cr×0.1)], limit 527.6M CU/week).

Core Features & Use Cases

  • Reads local Claude Code JSONL logs to compute tokens, messages, and compute units per model and pool.
  • Generates per-day and per-month views, burn-rate projections, and calibration-ready metrics.
  • Supports automatic model-limit calibration and adaptive data processing for evolving prompts.

Quick Start

Run token-track to begin analyzing your local Claude Code usage JSONL data.

Frequently Asked Questions about token-track

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

FAQPage Schema
How do I track Claude Code token usage and compute units from JSONL logs?

To track Claude Code token usage, you can run token-track to parse local JSONL logs. It filters duplicate streaming entries, maps usage to per-model metrics, and calculates compute units to reverse-engineer your actual usage limits.

How do I reverse-engineer Claude Code usage limits for capacity planning?

Reverse-engineering Claude Code usage limits involves analyzing ground-truth JSONL logs to deduce the weekly compute unit cap. This tool applies Formula A to calculate burn-rate estimates and per-model cost analyses for accurate capacity planning.

Can I get a daily and weekly burn-rate projection for Claude Code compute units?

Yes, you can generate burn-rate projections for Claude Code compute units. The tool reads your local JSONL history to produce per-day, per-week, and session-level breakdowns, enabling accurate tracking of your 527.6M weekly CU limit.

Does token-track work with local JSONL files to analyze per-model costs?

Yes, it works exclusively with local JSONL files to analyze per-model costs. The tool maps raw usage entries to specific models, filtering out duplicate streaming data to output structured metrics suitable for dashboards and calibration stores.

What is the formula for calculating Claude Code compute units from token usage?

The compute unit formula calculates CU by summing per-model multipliers across input, output, cache creation, and cache read tokens. Specifically, it uses the equation CU = Σ_model[mult × (inp×1.0 + out×5.0 + cc×1.25 + cr×0.1)].

How do I calibrate Claude Code model limits using local usage data?

You can calibrate Claude Code model limits by processing local JSONL logs to extract structured, calibration-ready metrics. The tool supports automatic model-limit calibration and adaptive data processing for evolving prompts.