AI Agent Hub
Back to plugins
dsh-usage-indicator preview

dsh-usage-indicator

Client Updated 2026.08.24

Run the following command in DeepSeek Harness:

dsh plugin install TiferKing/dsh-usage-indicator

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install TiferKing/dsh-usage-indicator in your local terminal; the source code is available at https://github.com/TiferKing/dsh-usage-indicator. Restart dsh web after installation to activate the plugin.

About this plugin

When you drive long conversations through DSH, the numbers that actually matter — how much context window is left, how much balance remains, and how many turns until the next compaction cycle — are usually buried in logs or raw API responses. dsh-usage-indicator pulls all three into a single card on the web sidebar so the fuel gauge is always within arm's reach, without pulling you out of your workflow.

The plugin tracks three core signals: a context-usage progress bar that turns yellow as it approaches the compaction threshold and red once it is hit; a balance bar that goes fully red when it drops below a warn line you set yourself; and a compaction-round estimate powered by EMA, which shows "evaluating" when there is not yet enough data. Everything stays local — your API key never leaves the machine. Collapse the sidebar and the card shrinks to a compact ring with a balance status dot. The settings panel lets you tune the full-balance cap, warn threshold, poll interval, and base URL; changes take effect hot with no restart required.

If you work with the DeepSeek API for long-document processing or multi-turn agent loops and manage sessions through DSH, this plugin turns three scattered numbers into one always-visible dashboard. Developers who want to anticipate the compaction window, keep a close eye on token spend, or simply like a small reassurance ring on the sidebar will find it a quiet but dependable companion to their daily workflow.

Screenshots

Use Cases

  • Check remaining context window at a glance during long conversations
  • Get early visual warnings when account balance drops below your threshold
  • Estimate compaction rounds to pace multi-turn agent loops

Best For

  • Developers managing DeepSeek API sessions via DSH
  • Long-document processors who watch token costs and balance
  • Daily DSH users who want an always-on usage dashboard