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-usage

cordis.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.

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:

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` host

The 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).

License

MIT