feat(sessions): surface /name session names in sidebar, dashboard and search

.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "name": "claude-devtools",
+  "description": "Audit Claude Code sessions for token waste: per-session findings and a cross-session inventory.",
+  "owner": {
+    "name": "axisrow",
+    "url": "https://github.com/axisrow/claude-devtools"
+  },
+  "plugins": [
+    {
+      "name": "session-audit",
+      "source": "./"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "session-audit",
+  "description": "Audit Claude Code session JSONLs for token waste: per-session ledger with findings (pnpm analyze:session) and a cross-session inventory (pnpm analyze:sessions).",
+  "author": {
+    "name": "axisrow"
+  }
+}

.github/workflows/ci.yml

@@ -3,31 +3,11 @@ name: CI
 on:
   push:
     branches: [main]
-    paths:
-      - 'src/**'
-      - 'test/**'
-      - 'package.json'
-      - 'pnpm-lock.yaml'
-      - 'tsconfig*.json'
-      - 'vite*.config.*'
-      - 'vitest*.config.*'
-      - 'tailwind.config.*'
-      - 'eslint.config.*'
   pull_request:
     branches: [main]
-    paths:
-      - 'src/**'
-      - 'test/**'
-      - 'package.json'
-      - 'pnpm-lock.yaml'
-      - 'tsconfig*.json'
-      - 'vite*.config.*'
-      - 'vitest*.config.*'
-      - 'tailwind.config.*'
-      - 'eslint.config.*'
 
 jobs:
-  validate:
+  ci:
     runs-on: ubuntu-latest
 
     steps:
@@ -44,39 +24,13 @@ jobs:
           cache: pnpm
 
       - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
+        run: pnpm install --frozen-lockfile
 
       - name: Typecheck
         run: pnpm typecheck
 
       - name: Lint
         run: pnpm lint
 
-      - name: Build
-        run: pnpm build
-
-  test:
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, windows-latest]
-    runs-on: ${{ matrix.os }}
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
-
       - name: Test
         run: pnpm test

CHANGELOG.md

@@ -6,6 +6,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 For the full list of merged PRs per release, see [GitHub Releases](https://github.com/matt1398/claude-devtools/releases).
 
+## Fork
+
+Development continues in this fork — see the [Upstream sync policy](README.md#upstream-sync-policy). Upstream entries below are kept unchanged.
+
+## [0.1.0-fork.1] — 2026-09-21
+
+### Added
+- Session-audit CLI: `pnpm analyze:session` (deep per-session ledger, waste findings, slow subagents, cost estimate) and `pnpm analyze:sessions` (session inventory), with a unified ccusage-style flag grammar (#1).
+- Session-audit CLI packaged as a Claude Code plugin with marketplace manifest and skills (#12).
+
+### Fixed
+- Treat the `Agent` tool as a subagent spawn (renamed from `Task` in Claude Code 2.1.63).
+- Short model ids parsed correctly; removed the `priceFamily` stopgap (#13).
+
 ## [Unreleased]
 
 ### Added

README.md

@@ -1,3 +1,6 @@
+> [!NOTE]
+> **Actively maintained fork** of [matt1398/claude-devtools](https://github.com/matt1398/claude-devtools) (upstream dormant since 2026-05). This fork carries new development: session-audit CLI and fixes. See the [Upstream sync policy](#upstream-sync-policy).
+
 <p align="center">
   <img src="resources/claude.png" alt="Your Claude is coding blind" width="600" />
 </p>
@@ -171,6 +174,15 @@ claude-devtools does **not** wrap, modify, or interfere with Claude Code. It rea
 
 ---
 
+## Upstream Sync Policy
+
+This repository is the actively maintained fork of [matt1398/claude-devtools](https://github.com/matt1398/claude-devtools); upstream has been dormant since 2026-05. Upstream is still fetched periodically, but it is not expected to move.
+
+- Local development happens in `main` and feature branches of this fork.
+- Open upstream PRs (e.g. [#235](https://github.com/matt1398/claude-devtools/pull/235)) are closed as "carried in fork" once their changes are applied locally.
+
+---
+
 ## Docker / Standalone Deployment
 
 Run without Electron — in Docker, on a remote server, or anywhere Node.js runs.
@@ -197,6 +209,53 @@ The standalone server has **zero** outbound network calls. For maximum isolation
 
 ---
 
+## CLI: Token Analytics
+
+Two scripts answer "where did the billed tokens go" with exact numbers from your JSONL sessions — no app, no rebuild:
+
+```bash
+# Deep audit of one session: per-turn/per-round ledger (input / cache_read /
+# cache_write / output), waste findings, slow subagents, cost estimate
+pnpm analyze:session <file.jsonl>
+pnpm analyze:session --project <dir-or-encoded-name> --last
+
+# Inventory of all sessions: duration, models, token totals, billing scheme
+pnpm analyze:sessions
+pnpm analyze:sessions --min-minutes 120 --sort tokens
+```
+
+Both commands share one flag grammar:
+
+| Flag | Effect |
+|------|--------|
+| `--json` | Machine-readable output (the single machine-readable mode) |
+| `--breakdown` | Per-model token/cost split (`analyze:session`: BY MODEL table + JSON `breakdown`; `analyze:sessions`: model share in the models column + JSON `tokensByModel` per session) |
+| `--since DATE` / `--until DATE` | Date-range filter (`YYYY-MM-DD` or `YYYYMMDD`; activity window for `analyze:session`, session last-activity dates for `analyze:sessions` — a session that ran past `--until` drops out) |
+| `--last N` | Relative shortcut for `--since`: last N calendar days, local midnight N−1 days back (ccusage-style). On `analyze:session` a bare `--last` (no value) keeps its original meaning: pick the newest session of `--project` |
+| `--no-cost` | Omit cost estimates (hides the cost line, JSON `costUsd`/`costPartial`, breakdown costs) |
+| `--project`, `--min-minutes`, `--sort`, `--limit`, `--subagent-min-minutes` | Existing per-command flags, unchanged |
+
+More examples:
+
+```bash
+# Token cost breakdown by model for the latest session of a project
+pnpm analyze:session --project my-project --last --breakdown
+
+# Audit only yesterday's rounds, without cost estimates
+pnpm analyze:session session.jsonl --since 2026-09-20 --until 2026-09-20 --no-cost
+
+# Sessions active in the last 7 days, newest first
+pnpm analyze:sessions --last 7 --sort date --limit 20
+```
+
+### Positioning vs ccusage
+
+[ccusage](https://github.com/ryoppippi/ccusage) computes **macro usage aggregates** — daily/monthly/blocks reports across many agent sources, plus a statusline. claude-devtools does the opposite: a **deep per-session audit** of Claude Code sessions (ledger, waste findings, subagents, inventory). Complementary tools, zero feature mixing: no daily/monthly/blocks aggregates, no multi-agent sources, no statusline, no pricing-sync network logic here — and no per-session waste audit in ccusage. The commands above deliberately reuse ccusage's flag *conventions* (`--json`, `--since`/`--until`, `--last N`, `--breakdown`, `--no-cost`) so the two tools feel consistent side by side.
+
+`--help` on either command prints the full flag list.
+
+---
+
 ## Development
 
 <details>

knip.json

@@ -3,6 +3,8 @@
   "entry": [
     "src/main/index.ts",
     "src/main/standalone.ts",
+    "src/cli/analyzeSession.ts",
+    "src/cli/sessionInventory.ts",
     "src/preload/index.ts",
     "src/renderer/main.tsx",
     "electron.vite.config.ts",

package.json

@@ -44,6 +44,10 @@
     "test:coverage": "vitest run --coverage",
     "test:coverage:critical": "vitest run --coverage --config vitest.critical.config.ts",
     "standalone": "tsx src/main/standalone.ts",
+    "analyze:session": "tsx src/cli/analyzeSession.ts",
+    "analyze:sessions": "tsx src/cli/sessionInventory.ts",
+    "loops:import": "tsx src/cli/importLoops.ts",
+    "turn-spend:stats": "tsx src/cli/turnSpendStats.ts",
     "standalone:build": "electron-vite build && vite build --config vite.standalone.config.ts",
     "standalone:start": "node dist-standalone/index.cjs"
   },
@@ -178,6 +182,8 @@
     "publish": [
       {
         "provider": "github",
+        "owner": "axisrow",
+        "repo": "claude-devtools",
         "releaseType": "draft"
       }
     ]