dsh-plugin-token-heatmap

How many Tokens did I burn today? Which days spiked? How much went to input versus output? These numbers are usually buried in individual chat logs with no time-series view to tie them together. dsh-plugin-token-heatmap fills that gap by rendering a vertical 12-month heatmap in the corner of the DeepSeek Harness Web GUI, using a five-level blue scale so daily Token totals are instantly readable at a glance.

The plugin offers two data perspectives — an all-sessions global view and a per-session view — switchable in real time from a floating window. On first launch it automatically backfills the last twelve months by scanning every historical session log, giving you the full picture immediately. After that, data polls every three seconds with version tagging and only repaints when something actually changed. The floating window is draggable, clamps its position within the viewport, remembers visibility and view preferences in localStorage, and adapts to both light and dark themes. Hovering over any date cell reveals a tooltip with input, output, cache-read, and cache-write breakdowns alongside today, weekly, monthly, and 12-month totals.

Whether you are a heavy daily user tracking personal Token spend or a team lead allocating API budget based on usage trends, this heatmap turns scattered numbers into a single glanceable visual. Once installed, a small square icon appears in the lower-right corner; the first-backfill runs silently in the background without blocking everyday use.