dsh-opencode-usage
A dsh web GUI plugin that shows your
OpenCode Zen balance and Go usage windows right in the composer tool row: a
concentric-ring button (rolling 5h / weekly / monthly) that opens a usage
panel.
- Host half (
src/index.ts→lib/index.js): resolves config from env
vars and$DSH_HOME/ocgo-usage.json, fetches the opencode.ai SSR pages,
and serves same-origin JSON endpoints with caching + failure cooldown. - Browser half (
src/client.tsx→lib/client.js): renders the
concentric-ring composer button and usage panel, and the config editor
(cookie values are only ever shown masked — the full cookie never leaves
the host).
Features
- Rolling 5-hour / weekly / monthly usage rings on a single composer button
- Usage panel with window details and a manual refresh
- Built-in config editor in the panel (masked cookie tails only)
- Smart cookie normalization: paste the raw auth token, a full header, or
anything in between - Server-side cache (default 5 min) + 60 s failure cooldown so the poller
never spams opencode.ai - Optional peak-clock display (
showPeakClock)
Install
# From a local checkout (or a tarball), add into the dsh web profile:
dsh plugin --profile web add /path/to/dsh-opencode-usagecordis.patch.yml inserts the plugin as opencode-usage; it requires the
webServer service.
Configuration
Priority: env vars > config file ($DSH_HOME/ocgo-usage.json) > defaults.
| Env var | Config file key | Default | Description |
|---|---|---|---|
OPENCODE_GO_COOKIE |
cookie |
— | OpenCode Go session cookie (auto-normalized) |
OPENCODE_GO_WORKSPACE_ID |
workspaceID |
— | OpenCode workspace id |
OPENCODE_GO_BASE_URL |
baseUrl |
https://opencode.ai |
Provider base URL |
OPENCODE_GO_CACHE_TTL |
cacheTTL |
300 |
Cache TTL in seconds, clamped to [60, 3600] |
OPENCODE_GO_TIMEOUT_MS |
timeoutMs |
15000 |
Fetch timeout in ms |
| — | showPeakClock |
false |
Show the peak-clock readout |
The cookie is never logged. You can also edit cookie / workspaceID /
showPeakClock from the panel's config editor; a successful write invalidates
the cache so the next poll uses the fresh values immediately.
Config file is written with chmod 600.
API
The browser half talks to the host over plain same-origin JSON:
| Method | Path | Description |
|---|---|---|
GET |
/api/opencode-usage |
Cached usage view |
GET |
/api/opencode-usage/refresh |
Force a fresh provider query |
GET |
/api/opencode-usage/config |
Masked config view |
POST |
/api/opencode-usage/config |
Write cookie / workspace / showPeakClock |
Development
npm install # dev deps (esbuild) — prepack build runs automatically
npm run build # emit lib/client.js + lib/index.js
npm run watch # hot-swap rebuilds into a running `dsh web` hostThe build mirrors the dsh plugin loader contract: the browser bundle rides in
the closure-factory module format with react/platform modules externalized,
and CSS is inlined idempotently (data-plugin-css).