Community plugin for DeepSeek Harness

See your real token usage in DSH.

A persistent, local-first Token Usage sidebar and settings page for the DeepSeek Harness web profile. Discover available history automatically, keep provider and model names accurate, and make every total easy to inspect.

Install the plugin View source
v1.1.6 MIT licensed Data stays local
DeepSeek Harness Token Usage settings page in English
Compact settings view · English interface
Built for the DSH web profile Available on npm Read the v1.1.6 release notes

Designed for useful history

Usage you can understand, not just a number.

The plugin follows DSH/provider-reported usage records and presents the result in a compact, native-looking interface.

↯

Automatic history discovery

Finds available plugin-owned token records in DSH storage without asking you to maintain a path or duplicate configuration.

▦

Compact settings

Range tabs, filters, metrics, provider/model rows, and recent local days stay readable in a smaller settings surface.

◫

Durable local ledger

A plugin-owned SQLite ledger with WAL mode keeps persistent accounting fast and survives DSH restarts and upgrades.

✓

Exactly-once accounting

Canonical invocation identities and replay-safe updates prevent retries and duplicate events from inflating totals.

⌁

Accurate provider names

Filters use the exact provider and model names reported by DSH. There is no second provider-name form to fill in.

◉

Private by default

Usage metadata remains on your machine. The ledger does not store prompts, assistant text, tool output, credentials, or API keys.

How it works

One local path from DSH to insight.

The plugin uses authoritative runtime usage when available, preserves raw labels, and reports the limits of recoverable history honestly.

  1. 01
    Collect

    Read committed DSH/provider usage records from live events and available local history.

  2. 02
    Deduplicate

    Use the canonical session, turn, and step identity so replays are counted once.

  3. 03
    Persist

    Store accounting metadata in the plugin-owned local SQLite ledger.

  4. 04
    Present

    Show totals, buckets, filters, provider/model detail, and recent local calendar days.

Get started

Install in the DSH web profile.

Install the scoped npm package through the DSH plugin command, then restart the web profile once so the loader can activate it.

Terminaldsh plugin --profile web add @y2zyyr/dsh-token-usage-sidebar # Restart dsh web after installation.
Open npm package Read installation details

Good to know

Questions people usually ask.

Does removing the plugin delete my totals?

No. The accounting ledger is stored separately under the DSH data home and is not removed by uninstalling the plugin.

Does the plugin estimate tokens from text?

No. It uses provider/runtime-reported usage records. Reasoning is shown as an output subdivision and is not added to the total twice.

Does discovery scan my whole computer?

No. Automatic discovery is intentionally narrow: it looks for recognized plugin-owned records in the relevant DSH storage area.

Is this an official DeepSeek plugin?

No. It is an independent community plugin for DeepSeek Harness.