@notenkidev/claude-token-dashboard 0.1.8 → 0.1.9

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.
Files changed (2) hide show
  1. package/README.md +18 -9
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -2,14 +2,15 @@
2
2
 
3
3
  > Visualize your [Claude Code](https://claude.ai/code) token usage by project and date — built with Next.js + Tailwind.
4
4
 
5
- ![Summary cards and daily chart](screenshot-1.jpg)
5
+ ![Summary cards and daily chart](screenshot.v2-1.png)
6
6
 
7
- ![Project breakdown table](screenshot-2.jpg)
7
+ ![Project breakdown table](screenshot.v2-2.png)
8
8
 
9
9
  ## Quick Start (No Install)
10
10
 
11
11
  ```bash
12
- npx @notenkidev/claude-token-dashboard
12
+ npm install -g @notenkidev/claude-token-dashboard
13
+ claude-token-dashboard
13
14
  ```
14
15
 
15
16
  Open http://localhost:3000
@@ -18,26 +19,34 @@ Open http://localhost:3000
18
19
 
19
20
  | Section | Details |
20
21
  |---|---|
21
- | **Summary cards** | Output tokens · Input tokens · Effective input · Cache read ratio · Project count · Session count |
22
+ | **Summary cards** | Estimated total cost · Output tokens · Input tokens · Effective input · Cache read ratio · Session count |
22
23
  | **Daily chart** | Input / output tokens per day (bar chart) |
23
- | **Project table** | Per-project breakdown sorted by total usage, with inline bar |
24
+ | **Project table** | Per-project breakdown sorted by cost, with inline bar |
24
25
 
25
26
  Cache read tokens from prompt caching are tracked separately — you can see at a glance how much of your effective input Claude is serving from cache (typically 90%+).
26
27
 
28
+ ## Features
29
+
30
+ - Token usage per project (output / input / cache read / cache create)
31
+ - Daily usage chart
32
+ - Cache read ratio
33
+ - Estimated cost in USD per project (claude-sonnet-4-6 pricing)
34
+ - Cost share % with warning for projects over 20% of total spend
35
+ - Total estimated cost since first session
36
+
27
37
  ## Quick start
28
38
 
29
39
  ```bash
30
- npx @notenkidev/claude-token-dashboard
40
+ npm install -g @notenkidev/claude-token-dashboard
41
+ claude-token-dashboard
31
42
  ```
32
43
 
33
44
  Open [http://localhost:3000](http://localhost:3000).
34
45
 
35
- On first run, dependencies are installed automatically (~30s). After that it starts instantly.
36
-
37
46
  **Custom port:**
38
47
 
39
48
  ```bash
40
- npx @notenkidev/claude-token-dashboard -p 4000
49
+ claude-token-dashboard -p 4000
41
50
  ```
42
51
 
43
52
  Reads `~/.claude/projects/**/*.jsonl` directly — no config, no API key needed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@notenkidev/claude-token-dashboard",
3
- "version": "0.1.8",
3
+ "version": "0.1.9",
4
4
  "description": "Visualize your Claude Code token usage by project and date",
5
5
  "bin": {
6
6
  "claude-token-dashboard": "bin/cli.js"