claude-session-dashboard 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,52 @@
+# Claude Session Dashboard
+
+A read-only, local observability dashboard for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions. Scans your `~/.claude` directory to visualize session details, tool usage, agent dispatches, token consumption, and execution timelines.
+
+## Usage
+
+```bash
+npx claude-session-dashboard
+```
+
+Or install globally:
+
+```bash
+npm install -g claude-session-dashboard
+claude-dashboard
+```
+
+Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+### CLI Options
+
+```
+  -p, --port <number>   Port to listen on (default: 3000)
+  --host <hostname>     Host to bind to (default: localhost)
+  -o, --open            Open browser after starting
+  -v, --version         Show version number
+  -h, --help            Show this help message
+```
+
+## Features
+
+- **Sessions list** with search, status filters, project filters, and pagination
+- **Session detail** with context window breakdown, tool usage stats, agent dispatch history
+- **Cost estimation** per session and per agent based on Anthropic API pricing
+- **Timeline chart** showing tool calls, agent runs, and skill invocations
+- **Stats page** with aggregate metrics across all sessions
+- **Live updates** for active sessions
+- **Privacy mode** to anonymize paths and usernames for safe screenshot sharing
+
+## How It Works
+
+The dashboard runs a local server that reads `~/.claude/projects/` to discover session `.jsonl` files. It parses them to extract metadata, tool calls, agent dispatches, and token usage, then displays everything in a web UI. No data leaves your machine.
+
+## Links
+
+- [GitHub](https://github.com/dlupiak/claude-session-dashboard)
+- [Issues](https://github.com/dlupiak/claude-session-dashboard/issues)
+- [Docker](https://github.com/dlupiak/claude-session-dashboard/pkgs/container/claude-session-dashboard)
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -3,7 +3,7 @@
 import { createServer } from 'node:http';
 import { readFile, access, stat } from 'node:fs/promises';
 import { resolve, join, extname } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { exec } from 'node:child_process';
 import { homedir } from 'node:os';
 
@@ -93,7 +93,7 @@ const MIME_TYPES = {
 
 process.env.NODE_ENV = 'production';
 
-const serverModule = await import(join(distDir, 'server', 'server.js'));
+const serverModule = await import(pathToFileURL(join(distDir, 'server', 'server.js')).href);
 const appServer = serverModule.default;
 
 async function tryServeStatic(pathname) {

package/dist/server/assets/{claude-path-CkuljM34.js → claude-path-on7ZBAjl.js}

@@ -17,9 +17,9 @@ function extractSessionId(filename) {
   return filename.replace(/\.jsonl$/, "");
 }
 export {
-  getStatsPath as a,
+  getProjectsDir as a,
   extractSessionId as b,
   decodeProjectDirName as d,
   extractProjectName as e,
-  getProjectsDir as g
+  getStatsPath as g
 };

package/dist/server/assets/{session-detail.server-azkRfON2.js → session-detail.server-ClCRw8BG.js}

@@ -1,7 +1,7 @@
 import { c as createServerRpc } from "./createServerRpc-Bd3B-Ah9.js";
 import * as path from "node:path";
 import * as fs from "node:fs";
-import { e as extractProjectName, g as getProjectsDir, d as decodeProjectDirName } from "./claude-path-CkuljM34.js";
+import { e as extractProjectName, a as getProjectsDir, d as decodeProjectDirName } from "./claude-path-on7ZBAjl.js";
 import { p as parseDetail } from "./session-parser-CAEXxF1D.js";
 import { c as createServerFn } from "../server.js";
 import "node:os";

package/dist/server/assets/{sessions.server-B8zbmvSM.js → sessions.server-Cl8Ao_-2.js}

@@ -2,7 +2,7 @@ import { c as createServerRpc } from "./createServerRpc-Bd3B-Ah9.js";
 import { z } from "zod";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { g as getProjectsDir, d as decodeProjectDirName, e as extractProjectName, b as extractSessionId } from "./claude-path-CkuljM34.js";
+import { a as getProjectsDir, d as decodeProjectDirName, e as extractProjectName, b as extractSessionId } from "./claude-path-on7ZBAjl.js";
 import { a as parseSummary } from "./session-parser-CAEXxF1D.js";
 import { c as createServerFn } from "../server.js";
 import "node:os";

package/dist/server/assets/{stats.server-BZWxV-mC.js → stats.server-BBNHZZ4h.js}

@@ -1,6 +1,6 @@
 import { c as createServerRpc } from "./createServerRpc-Bd3B-Ah9.js";
 import * as fs from "node:fs";
-import { a as getStatsPath } from "./claude-path-CkuljM34.js";
+import { g as getStatsPath } from "./claude-path-on7ZBAjl.js";
 import { z } from "zod";
 import { c as createServerFn } from "../server.js";
 import "node:path";

package/dist/server/server.js

@@ -577,12 +577,12 @@ function createMultiplexedStream(jsonStream, rawStreams) {
     }
   });
 }
-const manifest = { "ff8a3161afdfa175e9c519e4146a56ab5bce6e80745e99cfc2191ebbb7a859bb": {
-  functionName: "getSessionDetail_createServerFn_handler",
-  importer: () => import("./assets/session-detail.server-azkRfON2.js")
-}, "4b9a58c176f487b49800a372100037cdf33cf048f3592a449f115c7e3f5ea799": {
+const manifest = { "4b9a58c176f487b49800a372100037cdf33cf048f3592a449f115c7e3f5ea799": {
   functionName: "getStats_createServerFn_handler",
-  importer: () => import("./assets/stats.server-BZWxV-mC.js")
+  importer: () => import("./assets/stats.server-BBNHZZ4h.js")
+}, "ff8a3161afdfa175e9c519e4146a56ab5bce6e80745e99cfc2191ebbb7a859bb": {
+  functionName: "getSessionDetail_createServerFn_handler",
+  importer: () => import("./assets/session-detail.server-ClCRw8BG.js")
 }, "810657681a273df5b4e58f0d8fcc6a5451598b489431b9bcaa98eea0ad815da8": {
   functionName: "getSettings_createServerFn_handler",
   importer: () => import("./assets/settings.server-6B2PvLgf.js")
@@ -591,13 +591,13 @@ const manifest = { "ff8a3161afdfa175e9c519e4146a56ab5bce6e80745e99cfc2191ebbb7a8
   importer: () => import("./assets/settings.server-6B2PvLgf.js")
 }, "bf8e4a7901f1843bdc9c46be1ad5ad59c615b8bbe611b73eb3ff28f20e43ee0d": {
   functionName: "getSessionList_createServerFn_handler",
-  importer: () => import("./assets/sessions.server-B8zbmvSM.js")
+  importer: () => import("./assets/sessions.server-Cl8Ao_-2.js")
 }, "839d29fe93dfa2a6d506af7b48ca25197190a5ff4c796e970ddfdc6e8c98827f": {
   functionName: "getActiveSessionList_createServerFn_handler",
-  importer: () => import("./assets/sessions.server-B8zbmvSM.js")
+  importer: () => import("./assets/sessions.server-Cl8Ao_-2.js")
 }, "a3f42f9012fd83586787da8f7cb90649da739dd947d867eb67572f68735ff495": {
   functionName: "getPaginatedSessions_createServerFn_handler",
-  importer: () => import("./assets/sessions.server-B8zbmvSM.js")
+  importer: () => import("./assets/sessions.server-Cl8Ao_-2.js")
 } };
 async function getServerFnById(id) {
   const serverFnInfo = manifest[id];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-session-dashboard",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local observability dashboard for Claude Code sessions",
   "type": "module",
   "license": "MIT",
@@ -28,7 +28,8 @@
   "files": [
     "bin/",
     "dist/",
-    "LICENSE"
+    "LICENSE",
+    "README.md"
   ],
   "scripts": {
     "dev": "vite",