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

button
panel

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.

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