zcode-usage-stats

When you run multi-turn conversations in DeepSeek Harness, token spend can feel like a black box — how much went out each day, which model eats the most, where the peaks land. zcode-usage-stats puts a ready-made analytics dashboard right inside the DSH Settings page. It scans your full session history, aggregates token usage by day, by hour, and by model, then renders three views: a smooth multi-series area trend chart, a circular model-share gauge, and a GitHub-style activity heatmap. Time presets cover today, yesterday, last 7 days, last 30 days, this month, last month, and a fully custom range; when a single-day window is picked the x-axis automatically flips from days to hours.

The trend chart uses Catmull-Rom smoothing with reference lines, point-snap tooltips, and per-series legend toggles. The heatmap folds columns by window day and supports hover zoom with tooltips. Colors follow the DSH light or dark theme out of the box. Under the hood, a two-tier disk-plus-memory cache with stale-while-revalidate refresh keeps the first paint instant, while a bounded concurrency pool with timeout guards keeps scanning responsive even on large session libraries.

If you manage several models in DSH, need periodic token-cost reports, or just want a glanceable answer to what did I spend this week and on which model, this plugin slots into the Settings page with zero extra configuration.