dsh-opencode-go-usage
A DeepSeek Harness web plugin: a floating widget pinned to the right edge of the page that shows real-time OpenCode Go subscription usage — rolling / weekly / monthly windows (percent used, progress bar, and reset countdown) for every API key in the pool.
This repository is a maintained, account-scoped release of
@xiaweiliang060035/dsh-opencode-go-usage
(MIT). Install command and branding are updated for @mouseteamlucky/*.
Features
- Floating widget: compact button pinned to the right edge; the badge shows the worst-window percentage across all keys (green / orange / red breathing pulse by urgency).
- Expanded panel: one card per key (active key marked ★) with rolling / weekly / monthly usage bars, percentages, reset countdowns; rate-limited windows flagged ⚠; per-key errors shown inline.
- Live refresh: the Host polls the official usage endpoint; the panel auto-refreshes and offers a manual refresh.
- Key pool auto-discovery: reads
$DSH_HOME/.credentials.yaml entries (OPENCODE_GO_KEY_<name>); falls back to the active key (OPENCODE_GO_API_KEY) when no pool exists.
- Bilingual UI & DSH theme tokens (light/dark).
Install
dsh plugin --profile web add github:mouseteamlucky/dsh-opencode-go-usage
Then restart the DSH web app (the launcher/restart-guarded path) and refresh the browser page.
How it works
-
Host (Node ESM): discovers the key pool (config → .credentials.yaml → env layers), resolves each key through the credentials service, and calls the official endpoint:
GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <API_KEY>
Keys never leave the host — the browser only receives an aggregated snapshot.
-
Client (browser bundle): registers on the public shell.overlay slot and polls the Host route /plugins/dsh-opencode-go-usage/snapshot.
License
MIT. See LICENSE. Upstream fork attribution: xiaweiliang060035/dsh-opencode-go-usage.
