dsh-cost-track
Track token spend and enforce budgets for every model call your dsh agent makes.
Install
dsh plugin --profile web add dsh-cost-track
Or from source:
dsh plugin --profile web add github:hj01857655/dsh-cost-track
What it does
- Records every model call. Prompt tokens, completion tokens, and the model id are
priced and appended to
.cost/ledger.jsonl (append-only).
- Prices calls. A built-in table covers DeepSeek's models. Override with your own
rates for custom models.
- Budgets. Set a monthly spend limit. When cumulative spend crosses the threshold,
the plugin warns. With
enforce: true, subsequent model calls are blocked.
- Time-range queries. Filter spending by today, this week, this month, or an
arbitrary date range.
- Per-session breakdown. See which conversation burned the most tokens.
- Panel. A settings page shows today's spend, this month's spend, per-model
breakdown, recent sessions, and the budget bar.
CLI
dsh-cost-track summary # show spend summary
dsh-cost-track budget --monthly 50 --enforce # set $50/month budget with enforcement
dsh-cost-track record --model deepseek-chat --prompt-tokens 1000 --completion-tokens 500 --session s1
Pricing
Default rates (per million tokens, USD):
| Model | Prompt | Completion |
|---|
| deepseek-chat | $0.14 | $0.28 |
| deepseek-reasoner | $0.55 | $2.19 |
Override by writing .cost/pricing.json:
{
"my-model": { "promptPerMillion": 1.0, "completionPerMillion": 2.0 }
}
Panel
A Cost page inside Settings. The host registers GET /api/cost-track.panel and
rebuilds the payload from the ledger on every request, so the panel always reflects what
is on disk. A headless host has no web connection and simply skips the route.
The panel shows:
- Today / this month spend with a progress bar against the budget
- Per-model token and cost breakdown
- Recent sessions ranked by cost
- Budget status (OK / warning / exceeded) with the enforcement toggle
Layout
| Path | Role |
|---|
src/index.ts | Host half — apply(ctx), exposes the costTrack service |
src/cost.ts | Core cost tracker — record, query, aggregate |
src/pricing.ts | Built-in price table + custom pricing loader |
src/budget.ts | Budget checking and enforcement logic |
src/store.ts | Append-only .cost/ledger.jsonl |
src/cost-view.ts | Payload → view model, shared by host route and browser half |
src/cli.ts / src/bin.ts | Command-line entry, usable without dsh |
src/routes.ts | Panel route on the host's web connection |
src/client/view.tsx | Browser half — pure rendering |
src/client/index.tsx | Browser half — fetch and settings registration |
src/client/locales.ts | zh / en dictionaries |
Develop
npm ci
npm run typecheck
npm run build
npm test
License
MIT
