claude-usage-dashboard 1.0.5 → 1.1.0

package/README.md

@@ -1,52 +1,62 @@
-# Claude Usage Dashboard
-
-A self-hosted dashboard that visualizes your [Claude Code](https://claude.ai/code) usage by parsing local JSONL session logs from `~/.claude/projects/`.
-
-![Dashboard Screenshot](docs/screenshots/dashboard.png)
-
-## Features
-
-- **Token tracking** — Total tokens with breakdown by input, output, cache read, and cache write
-- **Cost estimation** — API cost equivalent at standard pricing, compared against your subscription plan (Pro / Max 5x / Max 20x)
-- **Token consumption trend** — Stacked bar chart with hourly, daily, weekly, or monthly granularity
-- **Model distribution** — Donut chart showing usage across Claude models
-- **Cache efficiency** — Visual breakdown of cache read, cache creation, and uncached requests
-- **Project distribution** — Horizontal bar chart comparing token usage across projects
-- **Session details** — Sortable, paginated table of every session with cost and duration
-
-## Quick Start
-
-Run directly without installing:
-
-```bash
-npx claude-usage-dashboard
-```
-
-Open http://localhost:3000 in your browser.
-
-### From Source
-
-```bash
-git clone https://github.com/ludengz/claudeUsageDashboard.git
-cd claudeUsageDashboard
-npm install
-npm start
-```
-
-The dashboard reads logs from `~/.claude/projects/` — if you use Claude Code, these already exist on your machine. Logs are parsed once at startup; restart the server to pick up new session data.
-
-## Tech Stack
-
-- **Backend:** Node.js, Express 5
-- **Frontend:** Vanilla JS (ES modules), D3.js v7
-- **Tests:** Mocha + Chai
-
-## Running Tests
-
-```bash
-npm test
-```
-
-## License
-
-ISC
+# Claude Usage Dashboard
+
+[![npm version](https://img.shields.io/npm/v/claude-usage-dashboard)](https://www.npmjs.com/package/claude-usage-dashboard)
+
+A self-hosted dashboard that visualizes your [Claude Code](https://claude.ai/code) usage by parsing local JSONL session logs from `~/.claude/projects/`.
+
+![Dashboard Screenshot](docs/screenshots/dashboard.png)
+
+## Features
+
+- **Token tracking** — Total tokens with breakdown by input, output, cache read, and cache write
+- **Cost estimation** — API cost equivalent at standard pricing, compared against your subscription plan (Pro / Max 5x / Max 20x)
+- **Token consumption trend** — Stacked bar chart with hourly, daily, weekly, or monthly granularity
+- **Model distribution** — Donut chart showing usage across Claude models
+- **Cache efficiency** — Visual breakdown of cache read, cache creation, and uncached requests
+- **Project distribution** — Horizontal bar chart comparing token usage across projects
+- **Session details** — Sortable, paginated table of every session with cost and duration
+
+## Quick Start
+
+Run directly without installing:
+
+```bash
+npx claude-usage-dashboard
+```
+
+Open http://localhost:3000 in your browser.
+
+### From Source
+
+```bash
+git clone https://github.com/ludengz/claudeUsageDashboard.git
+cd claudeUsageDashboard
+npm install
+npm start
+```
+
+### Custom Port
+
+```bash
+PORT=8080 npx claude-usage-dashboard
+```
+
+## How It Works
+
+The dashboard reads Claude Code session logs from `~/.claude/projects/` — if you use Claude Code, these already exist on your machine. Logs are parsed once at startup; restart the server to pick up new session data.
+
+## Tech Stack
+
+- **Backend:** Node.js, Express 5
+- **Frontend:** Vanilla JS (ES modules), D3.js v7
+- **Tests:** Mocha + Chai
+
+## Running Tests
+
+```bash
+npm test
+```
+
+## License
+
+ISC

package/bin/cli.js

@@ -1,20 +1,20 @@
-#!/usr/bin/env node
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const server = path.join(__dirname, '..', 'server', 'index.js');
-
-const child = spawn(process.execPath, [server], {
-  stdio: 'inherit',
-  // Attach child to the terminal's foreground process group
-  detached: false,
-});
-
-child.on('exit', (code) => process.exit(code ?? 0));
-
-// Forward signals to child
-for (const sig of ['SIGINT', 'SIGTERM']) {
-  process.on(sig, () => child.kill(sig));
-}
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const server = path.join(__dirname, '..', 'server', 'index.js');
+
+const child = spawn(process.execPath, [server], {
+  stdio: 'inherit',
+  // Attach child to the terminal's foreground process group
+  detached: false,
+});
+
+child.on('exit', (code) => process.exit(code ?? 0));
+
+// Forward signals to child
+for (const sig of ['SIGINT', 'SIGTERM']) {
+  process.on(sig, () => child.kill(sig));
+}

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "claude-usage-dashboard",
-  "version": "1.0.5",
-  "description": "Dashboard that visualizes Claude Code usage from local session logs",
-  "main": "server/index.js",
-  "bin": {
-    "claude-usage-dashboard": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "server/",
-    "public/"
-  ],
-  "scripts": {
-    "start": "node server/index.js",
-    "test": "mocha test/**/*.test.js --timeout 5000"
-  },
-  "keywords": [
-    "claude",
-    "usage",
-    "dashboard",
-    "token",
-    "cost"
-  ],
-  "author": "",
-  "license": "ISC",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ludengz/claudeUsageDashboard.git"
-  },
-  "type": "module",
-  "dependencies": {
-    "d3": "^7.9.0",
-    "express": "^5.2.1"
-  },
-  "devDependencies": {
-    "chai": "^6.2.2",
-    "mocha": "^11.7.5"
-  }
-}
+{
+  "name": "claude-usage-dashboard",
+  "version": "1.1.0",
+  "description": "Dashboard that visualizes Claude Code usage from local session logs",
+  "main": "server/index.js",
+  "bin": {
+    "claude-usage-dashboard": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "server/",
+    "public/"
+  ],
+  "scripts": {
+    "start": "node server/index.js",
+    "test": "mocha test/**/*.test.js --timeout 5000"
+  },
+  "keywords": [
+    "claude",
+    "usage",
+    "dashboard",
+    "token",
+    "cost"
+  ],
+  "author": "",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ludengz/claudeUsageDashboard.git"
+  },
+  "type": "module",
+  "dependencies": {
+    "d3": "^7.9.0",
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "chai": "^6.2.2",
+    "mocha": "^11.7.5"
+  }
+}