dsh-token-dashboard

When you run several DeepSeek Harness projects on the same machine, token spend is usually a numbers black box: no ready-made daily totals, no weekly trend, and the only way to check is to dig through session logs. dsh-token-dashboard turns that into a GitHub-contributions-style heatmap. A Token entry appears in the sidebar; click it and a dedicated panel opens with a weekly grid and a daily view, so you can instantly see which days and which projects consumed the most tokens.

The key architectural choice is projection over scanning. A persistent Worker listens to live session events, flushes them through the DSH durability barrier, and atomically commits usage deltas into a local SQLite database via node:sqlite. The panel fetches a single snapshot endpoint on every open, refresh, or page change — it never triggers log traversal, backfill, or any heavy read path. On first launch the database is initialized in the background while the panel shows a progress indicator; once ready, refreshes are near-instant. A small companion CLI (status, verify, rebuild, backups, restore, cleanup) covers local verification, rebuild, and backup of the projection.

It is well suited for engineers who run multiple DSH projects on a single machine and want a persistent, at-a-glance view of daily and weekly API token consumption — whether to control costs or simply because they enjoy dashboards and heatmaps. All data stays local; no external service is required.