Agent skill · data analytics · aradotso
token-dashboard-claude-analytics
Local token cost analytics dashboard for Claude Code sessions — reads JSONL transcripts and provides per-prompt cost breakdowns, heatmaps, and usage insights.
Why this skill is useful
Provides specific analytics and insights into Claude Code token usage that the AI wouldn't generate on its own.
What it needs
Requires python installed locally. About 4k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Token Dashboard — Claude Code Analytics Skill by ara.so — Daily 2026 Skills collection. Token Dashboard reads the JSONL transcripts Claude Code writes to ~/.claude/projects/ and turns them into per-prompt cost analytics, tool/file heatmaps, cache analytics, project comparisons, and a rule-based tips engine. Everything runs locally — no data leaves your machine. Installation No pip install. No Node.js. No build step. Requires Python 3.8+. Windows: Key CLI Commands Configuration Environment Variables Pricing Configuration Edit pricing.json directly to update model prices or add plans: Data Sources Claude Code writes session JSONL files here: OS Path --- --- macOS / Linux ~/.claude/projects/<project-slug>/<session-id>.jsonl Windows C:\Users\<you>\.claude\projects\<project-slug>\<session-id>.jsonl The dashboard only reads these files — never modifies them. It caches results in SQLite at ~/.claude/token-dashboard.db. Dashboard Tabs Tab What it shows --- --- Overview All-time totals, daily charts, cost by plan, top tools, recent sessions Prompts Most expensive user prompts ranked by tokens; click to see tool calls and result sizes Sessions Turn-by-turn view with per-turn tokens and tool calls Projects Per-project comparison: tokens, sessions, files touched Skills Most-invoked skills and their token costs Tips Rule-based suggestions (repeated file reads, oversized tool results, low cache-hit rate) Settings Switch between API / Pro / Max pricing plans API Endpoints The dashboard exposes JSON endpoints at http://127.0.0.1:8080/api/: Real Code Examples Scripting Against the SQLite Cache After running python3 cli.py scan, query the cache directly: Get Daily Token Totals Programmatic Scan via Python Fetch Overview Stats Programmatically Common Patterns Reset and Rebuild the Cache Run on a Different Port to Avoid Conflicts Export Tips to File Automate Daily Stats Logging Point at a Different Projects Directory Troubleshooting Problem Solution --- --- "No data" / empty charts Run …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/token-dashboard-claude-analytics