ds-balance

Working in the DeepSeek Harness web GUI, you often discover a depleted balance at the worst possible moment—the request simply fails and you realize the account is out of funds. ds-balance embeds a balance indicator directly in every session header, so you can confirm account status at a glance without switching windows or manually hitting the API endpoint.

It renders a compact pill on the right side of the session header showing currency and total (e.g. DS CNY 3.65), auto-refreshes every 60 seconds, and updates immediately on click. Hovering expands a breakdown of total, granted, and topped-up amounts with multi-currency awareness. The API key is read only from the DSH credential store or environment, carried exclusively in a subprocess environment so it never appears on the command line, in source, or in the browser. The entire call is a single read-only HTTPS GET—idempotent and side-effect free. If the key is missing or the request fails, the pill turns red and describes the reason in its tooltip.

ds-balance is for any developer calling the DeepSeek API through the dsh web interface, especially those making high-frequency calls, managing multiple projects in parallel, and wanting real-time balance awareness with zero configuration. Once credentials are set and dsh is restarted, the indicator appears in every session header with no further setup required.