DeepSeek Balance Whale Widget is a floating widget plugin for DeepSeek Harness that displays account balance and usage information.
The tool solves the problem of monitoring DeepSeek API account status without leaving the interface. It places a persistent bubble widget in the bottom-right corner of the DSH Web interface showing current account balance, today's usage, and per-conversation costs. The bubble content is fully customizable through click sequences, modular layouts, weighted random selection, and randomized text or images. The widget supports drag-and-drop repositioning, left-side adhesion with flip animation, and numeric scroll animations. It activates automatically with the interface and requires no session tokens to function.
The project is designed for developers using DeepSeek Harness who want real-time balance visibility without manual checking. It suits anyone running DSH Web who needs to track API spending at a glance. The repository maintains two separate product lines on different branches: the main branch for DSH Web interface integration, and a For-Codex branch for the Codex desktop application. These branches are incompatible with each other and maintained independently. Installation on the main branch uses the standard DSH plugin system with a single command, and the tool is available both as a published npm package and directly from the repository.
The project shows active maintenance with clear documentation distinguishing between its two separate product lines and their distinct installation methods. The repository provides detailed guidance on choosing between installation approaches and includes rollback documentation for version management. Development activity demonstrates attention to preventing user confusion through explicit warnings about branch incompatibility and installation method conflicts.
