dsh-usage

After running dozens or even hundreds of turns a day, the question that comes up most often is how many tokens were actually burned this week and whether the cache is really kicking in. The answers sit buried in dsh session logs, but nothing has laid them out in a glanceable view until now. dsh-usage solves exactly that: a single Usage button above the Settings entry in the sidebar opens a one-page panel where balance, hit rate, cost curves, heatmap, and line-item history are all visible at once.

A few of the most useful blocks: supplier balance reads DeepSeek and OpenRouter API keys, with credentials resolved on the host side only so the key never leaves your machine; the line chart aggregates the current day by the hour into a smooth curve with Token and Cost dual views, and hovering reveals the three-bucket breakdown for that hour; the heatmap works in two modes — time mode covering the last 13 weeks day-by-day and session mode showing every turn of every session — using GitHub's four-step green scale; and the history table is paginated at 15 rows per page with one-click CSV export that opens directly in Excel. Cost is estimated from official peak and off-peak pricing at the time of each request, with periodic online sync of the official price page so figures track rate changes.

Built for developers who lean on Harness heavily every day, or for anyone who wants to pull a quick snapshot of who used how much and how efficient the cache is for a team report. Everything is computed locally, no credentials are stored, nothing is uploaded, and the panel clearly labels cost figures as estimates rather than exact billing amounts.