# dsh-token-dashboard πŸ“Š [δΈ­ζ–‡](README.md) Β· [Changelog](https://github.com/Etheslay/dsh-token-dashboard/blob/main/CHANGELOG.md) Β· [MIT](https://github.com/Etheslay/dsh-token-dashboard/blob/main/LICENSE)

npm version license platform

> A **Codex-style usage profile** inside [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Settings: lifetime tokens, a year of activity, cache hit rate and top models β€” all of it read from local session logs, read-only and offline. --- ## πŸš€ Quick start (install) ```sh # --profile: desktop for the desktop app (Electron), web for `dsh web` dsh plugin --profile desktop add @etheslay/dsh-token-dashboard --registry=https://registry.npmjs.org/ ``` Restart DSH, then open **Settings β†’ Usage**. Requires DSH 0.2.x and Node β‰₯ 22.18. > πŸ’‘ To update, run the same command again β€” `@latest` picks up the new version. > πŸ’‘ Rather not type it? Send this to any agent that can run terminal commands: **"Install the DSH plugin @etheslay/dsh-token-dashboard into my desktop profile, then confirm it with `dsh --profile desktop --dump-config`."** > πŸ’‘ Keep `--registry`: the default registry in mainland China is npmmirror, which syncs newly published scoped packages with a delay β€” leaving it out can 404. ## ✨ Features - **Five all-time figures** β€” lifetime tokens, peak tokens, longest chat, longest streak, current streak. All cumulative, so there is no date-range picker - **A year of activity** β€” two stacked six-month blocks, in Daily / Weekly / Cumulative modes, with a `less β–’β–’β–’β–’β–’ more` ramp and a hover readout per day - **Insights** β€” most used reasoning Β· most used model (ranked by tokens, not by reply count) Β· skills explored Β· total skills used Β· total chats Β· total turns Β· cache hit rate - **Most used** β€” the skills invoked most often, with counts - **Bilingual** β€” follows the DSH UI language, and so do the numbers and durations: `3.7δΊΏ`, `46εˆ†59η§’` rather than `370M`, `46m 59s` - **Read-only, zero cost** β€” reads the session logs under `$DSH_HOME/sessions` and nothing else: no writes, no model calls, no prompt or message content sent anywhere - **No runtime dependencies** β€” the Host half imports only `node:*`; the browser half resolves React and the UI primitives from the DSH shell's module table - **Codex layout, DSH data** β€” reproduces the Codex analytics Overview layout and its formatting rules, and **invents nothing** DSH cannot measure: no quota, no plan name, no rate windows ## πŸ“Έ Screenshots ![Usage overview: five all-time figures and a year of activity](docs/panel-overview.png) ![Insights and most used](docs/panel-insights.png) > Taken from a real DSH session on this machine: 18 chats, 1.05 billion tokens, dark theme. Numbers and durations follow the UI language. ## πŸ“¦ Other ways to install - **npm page** β€” [`@etheslay/dsh-token-dashboard`](https://www.npmjs.com/package/@etheslay/dsh-token-dashboard): version, publish date and file list live there - **Plugin Market** β€” Settings β†’ Plugin Market β†’ search and install; the market maintains `dsh.profile.bundles` for you - **By hand** β€” `npm install @etheslay/dsh-token-dashboard`, then list the package under `dsh.profile.bundles` in the profile's `package.json`. **Both steps are needed**: a name declared in `bundles` but not installed makes DSH fail to start next time - **From source** β€” clone the repo, then `npm install && npm run build && npm run refresh:profile` (see Development) ## πŸ—‘οΈ Uninstall ```sh dsh plugin --profile desktop remove @etheslay/dsh-token-dashboard ``` Remove the package name from `dsh.profile.bundles` in that profile's `package.json` as well. The plugin leaves no user data behind β€” it only ever reads session logs. ## 🩺 Troubleshooting - **Installed, but Settings shows nothing** β€” check the profile first (the desktop app uses `desktop`), then run `dsh --profile desktop --dump-config` and look for `dsh-token-dashboard` in the config tree - **Is the Host half mounted?** β€” open `http://127.0.0.1:/dsh-token-dashboard/api/health`; `{"ok":true,…}` means it is - **"Plugin updated, restart DSH"** β€” expected. The browser half hot-reloads, but the Host half is an ES module cached in the Node process and needs a DSH restart ## πŸ§‘πŸ’» Development ```sh npm install npm run build # lib/index.js + lib/client.js + lib/types npm run typecheck npm test # fold, formatting and render, bilingual README, browser bundle, real-log cross-check npm run preview # render docs/panel.html from your own session store npm run check:layout # measure the panel in headless Chrome npm run refresh:profile # repack and install into the profile the app actually loads ``` **Editing `src/` does not change what the app runs.** The app loads the packed copy inside the profile; `npm run refresh:profile` is what replaces it, and Host-half changes additionally need a DSH restart. Tools are documented in [`tools/README.md`](tools/README.md). Design notes β€” panel geometry, the fold rules, how the colour ramp was derived, and the test strategy β€” live in [docs/design.md](https://github.com/Etheslay/dsh-token-dashboard/blob/main/docs/design.md). ## πŸ“„ License MIT β€” see [LICENSE](https://github.com/Etheslay/dsh-token-dashboard/blob/main/LICENSE) for the full text, and [NOTICE](https://github.com/Etheslay/dsh-token-dashboard/blob/main/NOTICE) for which Codex formatting rules were reproduced and from where.