bradywatkinson/dsh-nexus-usage-panel ↗★ 0
dsh-nexus-usage-panel
Nexus usage dashboard panel for the DSH Web GUI: mirrors the Fireworks Nexus desktop app's Overview card (plan tier, monthly % used, 5-hour session % used, reset times) by reading the same private nexusPlans/nexusPlanUsage REST API with the machine's keychain key.
설치
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:bradywatkinson/dsh-nexus-usage-paneldsh-nexus-usage-panel
Nexus usage dashboard panel for the DeepSeek Harness (DSH) Web GUI. It mirrors the Fireworks Nexus desktop app's Overview card — plan tier badge, "This month — N% used · Resets ", and "N% Current session · Resets at " with pink meters — as a Nexus Usage page in the DSH Web GUI, and goes beyond it with a per-model spend breakdown and an estimated savings + cache-hit line (Milestone 2 introspection).

How it works
The panel reads the same private REST API that nexus.fireworks.ai and the Nexus desktop app read — see docs/research-api.md for the full endpoint map:
| Endpoint | Purpose |
|---|---|
GET /v1/accounts/{account}/nexusPlans | Active plan tier + billing period |
GET /v1/accounts/{account}/users/{user}/nexusPlanUsage | monthly and 5-hour rollingWindow usage percents + reset times |
POST /v1/accounts/{account}/usageCosts:query | (Milestone 2) per-day, per-model spend |
Auth uses the per-machine key the Nexus desktop app minted at sign-in, stored in the macOS login keychain (service FireworksAI, account fireworks-api-key). The key never leaves the host process; the browser only ever sees sanitized percentages. Overrides: FIREWORKS_NEXUS_KEY env or the plugin's apiKey config; gateway override via NEXUS_GATEWAY_URL / gatewayBase config.
Note: the API exposes percentages of your plan limits only — dollar allowances are not disclosed to members. DSH sessions themselves run through Nexus Auto (api.fireworks.ai/inference/v1, model auto); Fireworks routes server-side and does not echo the routed model id to the client.
Install