AI Agent Hub
Back to plugins
DeepSeek-Balance-Whale-Widget preview

DeepSeek-Balance-Whale-Widget

Client Updated 2026.08.27

Run the following command in DeepSeek Harness:

dsh plugin install MeteorNOX/DeepSeek-Balance-Whale-Widget

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

Run `dsh plugin install MeteorNOX/DeepSeek-Balance-Whale-Widget` in DeepSeek Harness to install this plugin from https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget.

About this plugin

As a heavy user of DeepSeek Harness, have you ever worried about running out of API balance in the middle of a conversation? Switching to the platform page to check balance is a hassle. This little whale widget is exactly built for that—it stays in the bottom-right corner of the DSH web UI, appears automatically every time you open the interface, and puts your DeepSeek API balance, today's usage, and per-turn cost right in front of you.

The core features are thoughtful: balance auto-refreshes every 60 seconds, clicking the whale refreshes manually, and there's a rolling animation when the number changes. Today's usage comes in two modes—the default 'whale bookkeeping' works with zero config, tracking balance differences automatically once you've set your API key, and archives across days; for more precision, you can switch to the 'realtime token' mode, which calls the platform usage API and converts costs with peak/off-peak pricing. Even better, after each conversation turn, a popup shows the exact cost based on real usage, with no extra token needed. The widget itself is playful: drag it to any edge for snap-fitting (with horizontal mirroring on the left), press for a squishy effect, and tweak size, sounds, and bubbles via the hamburger menu.

Who is this for? If you're a DSH user—especially developers who rely heavily on the DeepSeek API, track costs, or just want to know how much each chat round costs—this widget gives you real convenience with almost no setup. For those who don't want to deal with tokens, the default mode works out of the box; for precise reconciliation, the token mode has you covered. In short, it's a practical and adorable little tool that makes API usage tracking easy and fun.

Editor's note

Written for AI Agent Hub. This is separate from the publisher description above.

What problem it solves

A long Harness session can run the API balance down while you are looking at the code. This widget surfaces the balance so you notice before the call fails. The problem is a missing number, not a missing model.

Who it is for

Heavy DeepSeek API users who already have a key and want a glanceable remainder. You understand that the widget reads account data.

Who should skip it

Skip it if you do not use DeepSeek's API. The widget will not explain another vendor's invoice. Skip it if you wanted routing or a cheaper model. That is the routing suite or a different model row. A balance display does not move traffic. Skip it if putting an API credential into another plugin bothers you more than switching to the vendor's billing page. The billing page is the alternative and it has no install step.

First three steps

  1. Read which credential it uses. Prefer a read-only or billing-scoped key if the vendor offers one.
  2. Compare the number to the official balance page.
  3. If they match, leave the widget. If they disagree, trust the official page and uninstall the widget until you know why. Do not "fix" a mismatch by installing a router.

Alternatives on this site

The vendor's billing console is enough if you only check once a day. An inference plugin that saves money is a different project: it changes calls, it does not display them. Do both only when each one has passed its own test.

Questions

Can the whale spend money? The widget should not. Any plugin holding a key might, if the permission is broader than read. Check the scope.

Does a low balance mean the model got worse? No. It means you are about to be unable to call it.

Screenshots

Use Cases

  • Keep an eye on your DeepSeek balance directly in the DSH web UI, avoiding mid-conversation interruptions due to insufficient funds
  • See the exact cost right after each conversation turn, making it easy to control per-session spending
  • Convert today's usage into accurate costs with peak/off-peak pricing, perfect for daily API expense reconciliation

Best For

  • DeepSeek Harness users who want balance and usage at a glance
  • Developers heavily relying on the DeepSeek API who need fine-grained per-turn cost tracking
  • Individuals or teams focused on cost transparency who want a zero-config tool to simplify expense tracking

Reader reviews

No approved reader reviews on this listing yet. Yours can be the first.

Reviews are held for moderation and appear after an editor approves them. No links or promotion.