DeepSeek Harness balance plugins: DSH plugin cost meters
The money-watching DSH plugins in DeepSeek Harness fall into three kinds: balance display (the whale widgets), cost meters such as dsh-cost-meter, and usage statistics panels such as dsh-usage-stats (source). They answer different questions — "how much is left", "what did this turn cost", "how was this month spent" — so decide which reading you want first. To browse the category side by side, filter the market on DSH Plugin Hub by balance, usage and cost keywords.
The three kinds of money-watching DSH plugin
They differ not in how many features they carry but in what they read: a balance is money left, a cost meter is money spent, a usage panel is the shape of consumption (source). One by one:
- Balance display. Answers only "how much is left". The representative is the balance whale widget (
dsh-whale-widget), resident in a corner, refreshing on a timer and refreshable by hand; it reads from the DeepSeek Harness credential or the account login state. - Cost meter. Turns the spend of a session into money. The representative is
dsh-cost-meter, tracking session and daily cost plus budget and balance, with Coding Plan quota lookups, peak and off-peak pricing reminders and token usage heatmaps. - Usage statistics panel. Turns consumption into a dashboard you can revisit. Entries such as
dsh-usage-statsbreak token usage down by day and by model, which is for reviewing data rather than watching a balance live.
What the three share is that they are read-only: they read the balance, the bill and session usage to display it, and never call a model on your behalf or change session content.
What each kind answers: a question-to-category map
Instead of comparing feature lists, start from the sentence you would say out loud; it maps to exactly one kind (source).
| Your question | Kind to pick | What you get |
|---|---|---|
| "How much money is left?" | balance display | account balance, today's spend |
| "What did this session cost?" | cost meter | session and daily cost, budget |
| "Where did the spend go by token or model?" | cost meter or usage panel | token breakdown, heatmaps |
| "How was this month spent?" | usage panel | daily and per-model trends |
| "Am I near a plan quota?" | cost meter | plan quota and pricing reminders |
The table has five rows but only three destinations, which is the point: overlap is real, and picking by question keeps you from installing two plugins that report the same thing.
How to choose a DSH plugin: balance, cost, or a panel
Which kind to pick depends on the number you want to see the moment you open the interface (source). Match it to the need:
- Watch the balance only: choose a balance display, and one resident widget is enough — the account remainder is visible in a corner without opening a statistics page.
- Cost per session: choose a cost meter, which shows what this turn or today cost along with budget, peak pricing and quota reminders.
- Review usage: choose a usage statistics panel for daily and per-model token structure and trends.
One practical note: the three overlap, so one is usually enough. A balance widget plus a cost meter crowds the interface and muddles the readings; settle the need first, then install one.
Combining them: three things to watch
If you do install more than one, three specific collisions are worth avoiding (source).
- Placement clash. Resident widgets compete for the same corner — the balance whale and a desktop pet both take the lower-right; hide or move one.
- Do not mix readings. "Money left" and "money spent" move in opposite directions: a top-up raises the balance, which is not negative spend. Comparing a balance panel against a cost meter without labelling them reads as a contradiction.
- Do not mix sources. The npm name and the
github:form of the same plugin are one package; installing both leaves duplicates and confusing readings.
Where to manage and update these DSH plugins afterwards
These balance and usage plugins all install with the standard dsh plugin --profile web add <package>, and are then managed from the market in DSH Plugin Hub. Keep the two entry points apart:
- Install and update by CLI: install with
dsh plugin --profile web add <package>and remove withdsh plugin --profile web remove <package>; npm names andgithub:installs are two separate sources, so do not install the same plugin through both. - Browse and verify in the market: the DSH Plugin Hub market groups entries by purpose and shows each one's source repo and compatibility state, which is how you compare implementations and confirm something is still maintained.
Verifying the DSH plugin you chose actually landed
Check the listing and the loaded bundles before deciding a plugin does not work.
# 1) Which of the three kinds did you actually install?
dsh plugin --profile web list
# expect the balance / cost / usage plugin you chose, each listed once
# 2) Is each of them loaded as a bundle in the web profile?
grep -A5 "bundles" "$DSH_HOME/profiles/web/package.json"
# each installed plugin should appear among the loaded bundles
Expected: every plugin you chose appears once in the listing and once among the bundles. A plugin that is listed but not loaded will not show up in the interface — restart the profile's process. A duplicate in the listing means you installed the same plugin through two sources.
Notes on DSH plugin balance and usage
Keep the three readings apart and you will not end up with several installed and a muddled picture.
- Separate the readings first: balance is money left, cost is money spent, usage is the shape of consumption.
- Install one as needed: the features overlap, so more only crowds the interface.
- Do not mix sources: npm names and
github:are separate sources that conflict when combined. - Mind the profile: use
--profile webfor the Web interface; the desktop app uses its own Plugins page. - Roundups are a different article: the full plugin ranking and scenario picks are elsewhere; this piece covers only the balance and usage niche.
- The single-plugin guide is in balance whale widget install.
- Find similar plugins on DSH Plugin Hub by keyword.
Common misconceptions about DSH plugin balance and usage plugins
Five beliefs that lead to the wrong install:
- "A balance panel and a cost meter show the same number." No — one is money left, the other money spent, and they move in opposite directions.
- "More of these plugins means better monitoring." Usually not — the features overlap and the extra panels crowd the interface.
- "A balance that went up means I spent less." No — a balance increase is usually a top-up or credit, not negative consumption.
- "Installing it is enough; nothing else to check." No — confirm it is loaded as a bundle, or it will not appear after a restart.
- "npm name and
github:are two different plugins." No — they are the same package through two sources, and installing both creates a duplicate.
Source: DeepSeek Harness CLI README, Community plugin repo - DeepSeek Balance Whale Widget, Community plugin repo - dsh-cost-meter.
FAQ
The money-watching DSH plugins fall into roughly three kinds: balance display, cost meters, and usage statistics panels. A balance display answers "how much is left"; a cost meter works out what a session or token spend cost; a usage panel turns daily and per-model consumption into a dashboard.
For a running balance, a balance display DSH plugin is the least trouble, and the whale widget is the representative case. It sits in a corner and refreshes on a timer, so you never open a statistics page; if the balance is the only number you care about, you do not need a cost meter.
For per-session token cost, pick a cost-meter DSH plugin — dsh-cost-meter is the representative case. It tracks session and daily cost plus budget and balance, breaks usage down by token, and suits anyone controlling spend; its reading is money spent, not money left.
Usually not: pick the DSH plugin that answers your question, because the features overlap. A balance display if you watch the account, a cost meter if you track spend, a usage panel if you review data afterwards. Installing more only crowds the interface.
These DSH plugins all install through dsh plugin --profile web add and are then managed from the plugin market in DSH Plugin Hub. The market shows each entry, its source repo and its compatibility state, which is also where you check for updates and compare similar implementations.
Related Terms
- dsh-whale-widget
- dsh-whale-widget is the representative balance display plugin, resident in a corner of the interface and showing the DeepSeek account balance and today's usage; it is a display panel, not a meter.— Community plugin repo - DeepSeek Balance Whale Widget
- dsh-cost-meter
- dsh-cost-meter is a cost meter plugin: it tracks session and daily cost plus budget and balance, and supports Coding Plan quota lookups, peak and off-peak pricing reminders and token usage heatmaps.— Community plugin repo - dsh-cost-meter
- usage statistics panel
- A usage statistics panel is a plugin that turns daily and per-model token usage into a dashboard, represented by entries such as dsh-usage-stats; it is for reviewing data rather than watching a balance live.— DSH CLI README (plugin add and profiles)
- profile
- A profile is the ordered stack of plugin layers DeepSeek Harness boots; these balance and usage plugins all install through `dsh plugin --profile web add`.— DSH CLI README (plugin add and profiles)
Sources
- DSH CLI README (plugin add and profiles)· deepseek-ai
- Community plugin repo - DeepSeek Balance Whale Widget· community
- Community plugin repo - dsh-cost-meter· community