A bouncy whale that audits your DeepSeek spend
A DSH plugin that parks a draggable, squishy whale in your corner to track DeepSeek API balance, daily usage, and per-turn costs in real time.

What it does
This is a standard DeepSeek Harness (DSH) bundle plugin that adds a floating whale widget to the bottom-right of the DSH web UI. It polls your DeepSeek API balance every 60 seconds, tracks today’s spending, and can surface the exact cost after each conversation turn. The widget snaps to screen edges, mirrors itself when docked to the left, and squishes like a stress toy when clicked.
The interesting bit
The clever part is its dual-mode accounting. By default it infers daily usage from balance deltas stored locally—no platform token required—so it works out of the box with just an API key. If you want precision, hand it a DeepSeek platform session token and it switches to real-time peak/valley pricing. It also hooks into local DSH session events to calculate per-turn costs from exact token usage rather than estimating.
Key highlights
- Auto-refreshes balance every 60s with rolling number animations
- Two usage-tracking modes: zero-config local bookkeeping or precise platform-token-based peak/valley pricing
- Per-turn cost popups using actual model usage data from DSH session events
- Drag-and-drop with quarter-screen edge snapping and horizontal flip on left-side dock
- Configurable burger menu for size, sound effects, and feature toggles
Caveats
- Requires DeepSeek Harness (DSH) to function; not a standalone tool
- The real-time usage mode needs a DeepSeek platform session token, which expires when you re-login to the platform
- Sound effects and GIF reactions are optional assets; missing files silently degrade instead of breaking
Verdict
Worth installing if you run DeepSeek Harness and want at-a-glance spend tracking with personality. Skip it if you don’t use DSH or if floating mascots make you irrationally angry.
Frequently asked
- What is MeteorNOX/DeepSeek-Balance-Whale-Widget?
- A DSH plugin that parks a draggable, squishy whale in your corner to track DeepSeek API balance, daily usage, and per-turn costs in real time.
- Is DeepSeek-Balance-Whale-Widget open source?
- Yes — MeteorNOX/DeepSeek-Balance-Whale-Widget is open source, released under the MIT license.
- What language is DeepSeek-Balance-Whale-Widget written in?
- MeteorNOX/DeepSeek-Balance-Whale-Widget is primarily written in JavaScript.
- How popular is DeepSeek-Balance-Whale-Widget?
- MeteorNOX/DeepSeek-Balance-Whale-Widget has 558 stars on GitHub.
- Where can I find DeepSeek-Balance-Whale-Widget?
- MeteorNOX/DeepSeek-Balance-Whale-Widget is on GitHub at https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget.