claude-usage-dashboard 1.2.1 → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,11 +10,13 @@ A self-hosted dashboard that visualizes your [Claude Code](https://claude.ai/cod
|
|
|
10
10
|
|
|
11
11
|
- **Token tracking** — Total tokens with breakdown by input, output, cache read, and cache write
|
|
12
12
|
- **Cost estimation** — API cost equivalent at standard pricing, compared against your subscription plan (Pro / Max 5x / Max 20x)
|
|
13
|
+
- **Subscription quota** — Real-time utilization gauges (5-hour, 7-day, per-model) pulled from the Anthropic API with auto-detection of your plan tier
|
|
13
14
|
- **Token consumption trend** — Stacked bar chart with hourly, daily, weekly, or monthly granularity
|
|
14
15
|
- **Model distribution** — Donut chart showing usage across Claude models
|
|
15
16
|
- **Cache efficiency** — Visual breakdown of cache read, cache creation, and uncached requests
|
|
16
17
|
- **Project distribution** — Horizontal bar chart comparing token usage across projects
|
|
17
18
|
- **Session details** — Sortable, paginated table of every session with cost and duration
|
|
19
|
+
- **Auto-refresh** — Dashboard polls every 30s for new usage data; quota refreshes every 2 minutes
|
|
18
20
|
|
|
19
21
|
## Quick Start
|
|
20
22
|
|
|
@@ -43,7 +45,9 @@ PORT=8080 npx claude-usage-dashboard
|
|
|
43
45
|
|
|
44
46
|
## How It Works
|
|
45
47
|
|
|
46
|
-
The dashboard reads Claude Code session logs from `~/.claude/projects/` — if you use Claude Code, these already exist on your machine. Logs are
|
|
48
|
+
The dashboard reads Claude Code session logs from `~/.claude/projects/` — if you use Claude Code, these already exist on your machine. Logs are automatically re-read every 5 seconds, and new usage appears without restarting the server.
|
|
49
|
+
|
|
50
|
+
Subscription quota data is fetched from the Anthropic API using your local OAuth credentials (`~/.claude/.credentials.json`). Your plan tier (Pro / Max 5x / Max 20x) is auto-detected from the same file.
|
|
47
51
|
|
|
48
52
|
## Tech Stack
|
|
49
53
|
|