dsh-budget
Cost governance, token metering, budget caps, carbon estimation, and latency tracking for DeepSeek Harness.
Install
$ dsh plugin --profile web add github:PerryLink/dsh-budgetPlugin Overview & Capabilities
AI-assisted organization based on the public repository snapshot. The content must be grounded in source evidence and does not replace compatibility or security verification.
Key Capabilities
- Monitors token usage across uncached input, output, cache reads, and cache writes with USD cost estimation
- Enforces session, daily, and monthly budget caps with warn-ratio thresholds
- Supports alert, block, and degrade over-limit policies via the llm/stream waterfall seam
- Delivers desktop notifications and outbound JSON webhook alerts on budget thresholds
- Estimates carbon footprint (kWh and regional grid intensity) and tracks per-model latency benchmarks
- Provides a Web UI Settings budget tab and /budget command-line interface with unblock controls
Useful For
- Preventing unexpected API expenditure across long-running or autonomous agent sessions
- Visualizing model latency and token consumption metrics directly within DeepSeek Harness
- Automatically downgrading expensive models to cheaper alternatives when reaching cost thresholds
- Estimating carbon footprint impact across DeepSeek Harness workloads
Who It Fits
- DeepSeek Harness developers and administrators managing token spending
- Teams requiring budget limits and webhook notifications for multi-model usage
- Engineers tracking model latency and environmental footprint metrics
Documented Limitations
- Maintenance status is frozen as of 2026-10-05 with no further feature additions planned
- Usage aggregation is process-local and resets on restart without storage domain persistence
- Enforcement via block and degrade policies requires the llm/stream waterfall seam on the host harness
- Audit events budget/alert and budget/block are suppressed on DSH 0.1.2-rc.1+ due to strict session event validation, degrading audit tracking to logger and webhook
- Built-in pricing tables may drift without explicit model price overrides
DSH Compatibility
Version-specific runtime evidence collected by DSH Plugin. A missing result means we have not tested that combination yet.
Security Signals
Objective signals discovered from package metadata and source inspection. These are not a guarantee that a plugin is safe.
package.json declares 3 runtime, 26 development, 13 peer, and 0 optional dependencies.
package.json declares DSH bundle metadata.
GitHub reports the repository license as Apache-2.0.
A root package.json was captured and can be inspected by the registry.
package.json declares a prepare lifecycle script that may run during relevant package installation workflows.
Public GitHub source metadata is available for this registry snapshot.
Source & Registry Notes
Public provenance, Registry classification, and the latest source check for this entry, kept separate from runtime verification.
- Source repository
- PerryLink/dsh-budget
- Registry source
- GitHub · dsh-plugin topic
- Registry classification
- Plugin
- Source checked
- bd8ec79 · 2026-10-11
This project is independently indexed from public source information. DSH Plugin is not affiliated with DeepSeek or the plugin author. Always check the author repository before installation.
Repository Activity
- GitHub stars
- 10GitHub stars
- Forks
- 0
- Open issues
- 1
- Last commit
- 2026-10-10
- Last release
- 2026-10-10
Related DSH Plugins
Ranked by overlapping capabilities, use cases, plugin type, categories, and DSH profile.
Persistent multi-model agent teams with dynamic DAG orchestration, run monitoring, and token insights for DeepSeek Harness.
View plugin →Second-model AI auto-review for DeepSeek Harness approval requests with fail-closed fallback and session audit logging.
View plugin →Native SQLite-backed task management and project board bundle with Web UI and Agent workflow tools for DeepSeek Harness.
View plugin →Compatibility bridge running unmodified Pi ecosystem extensions natively on DeepSeek Harness.
View plugin →