dsh-token-usage
Persistent token usage records, cost estimation, and observability dashboard for DeepSeek Harness.
Install
$ dsh plugin --profile web add github:LeemanCheung/dsh-token-usagePlugin 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
- Tracks four token buckets including uncached input, output, cache read, and cache write with retry and context compaction accounting
- Provides a 30-week UTC heatmap, period trends (7/30/90 days), and near real-time confirmed output token rate sampling
- Calculates USD cost estimates and cache savings based on static public rate tables and custom versioned rate cards
- Enables rolling 30-day token and amount budgets with 80% warning, 100% overrun, and 7-day run-rate projections
- Generates deterministic session trajectory breakdowns and opt-in AI usage optimization reports with privacy allowlists
- Supports aggregation exports to JSON v3 and CSV formats with formula-injection guards
Useful For
- Auditing and visualizing LLM token consumption across multiple providers and models in DeepSeek Harness
- Tracking agent execution efficiency, retry overhead, and context compaction rates
- Setting rolling token and cost budget alerts to prevent unexpected API expenditure
- Analyzing individual session trajectories to inspect turn-by-turn token distribution and tool calls
Who It Fits
- DeepSeek Harness web users monitoring API token usage and operational expenses
- Developers building and profiling complex multi-turn or multi-tool agents
- Administrators requiring privacy-preserving token audit trails and usage exports
Documented Limitations
- Cost calculations rely on static public price tables or user-defined rate cards and do not represent live provider billing or invoice sync
- Session trajectory history is stored in local browser storage (up to 24 reports) and does not synchronize across browsers
- UI dashboards and interactive trajectory views are only available on the web profile
- Provider breakdowns do not isolate fine-grained sub-agent, system prompt, or retrieval token buckets if the provider does not expose them
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 0 runtime, 0 development, 25 peer, and 0 optional dependencies.
package.json declares DSH bundle metadata.
GitHub reports the repository license as MIT.
A root package.json was captured and can be inspected by the registry.
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
- LeemanCheung/dsh-token-usage
- Registry source
- GitHub · dsh-plugin topic
- Registry classification
- Plugin
- Source checked
- 94db895 · 2026-10-23
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
- 12GitHub stars
- Forks
- 1
- Open issues
- 0
- Last commit
- 2026-09-27
- Last release
- 2026-09-02
Related DSH Plugins
Ranked by overlapping capabilities, use cases, plugin type, categories, and DSH profile.
Cost and token tracking plugin for DeepSeek Harness featuring session budgets, provider balances, and coding plan quotas.
View plugin →DeepSeek Harness balance and token monitor with whale-girl companion animations and visual billing rules.
View plugin →Generative UI plugin for DeepSeek Harness that renders interactive cards, charts, forms, and panels inline from dsh-ui code fences.
View plugin →Interactive reasoning-effort slider and runner visual integration for DeepSeek Harness model selectors.
View plugin →