dsh-opencode-go-usage

dsh-opencode-go-usage

A DeepSeek Harness web plugin that shows your OpenCode Go quota next to the context status area in the chat composer.

• Hover the icon: shows the 5-hour rolling quota remaining and starts an auto refresh (throttled to once every 15 seconds)
• Click the icon: opens a panel with remaining / used percentages and reset times for 5h, weekly, and monthly windows
• The icon is visible when the current session's selected provider is an OpenCode Go route: opencode-go or a route key derived from it (opencode-go-extra, ...)
• Caches the last successful result globally: reopening the panel shows cached data and last query time immediately, then refreshes in the background
• While a query is in flight, the hover tooltip shows refreshing…; clicking the icon during that time does not start a duplicate request
• Auto refresh is limited to once per 15 seconds; manual refresh always queries

Demo

After installing and restarting dsh web, open a session using opencode-go. A small icon appears on the right side of the composer. Click it to see:

OpenCode Go quota
5h    left 85%
Wk    left 71%
Mo    left 93%
last query: 14:32:08 · refreshing…

Install

From GitHub (recommended)

dsh plugin --profile web add github:GarfieldGCat/dsh-opencode-go-usage

Then restart:

dsh web

Pin a release tag for stable installs:

dsh plugin --profile web add github:GarfieldGCat/dsh-opencode-go-usage#v0.3.1

Compatibility

dsh 0.2 validates every strict Typert codec where it is registered — the invocation result codec in typert.host.js and the matching descriptor in client.js — and requires each to expose a create() factory returning the schema. A codec carrying only a bare schema is refused, and because the typert loader aggregates contributor failures, one such codec aborts the whole activation pass and the plugin never loads:

typert-loader: dsh-opencode-go-usage invocation
"dsh-opencode-go-usage#opencodeUsage/usage" result codec has no create() factory

Earlier releases ignored the field, so the create() form in this release works on both. See typert.host.js and the contribution in client.js for the exact declaration.

Configuration

You can override the plugin config in your web profile's cordis.patch.yml:

- id: opencode-go-usage
  name: dsh-opencode-go-usage
  config:
    baseUrl: https://opencode.ai/zen/go/v1/usage
    timeoutMs: 15000
    providerIds:
      - opencode-go
      - opencode-go-extra

The browser half cannot read this config, so it matches the catalog id opencode-go plus any opencode-go-* derived key by rule. A custom route named anything else needs a one-line change to isOpenCodeGoRoute in client.js.

API key resolution

1. DSH credentials seam / environment variable OPENCODE_GO_API_KEY
2. ~/.local/share/opencode/auth.json, entry opencode-go (falls back to opencode) with type: "api"

How it works

Usage endpoint

GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer <API_KEY>

Example response:

{
  "usage": {
    "rolling": { "status": "ok", "percent": 9,  "resetsAt": "..." },
    "weekly":  { "status": "ok", "percent": 12, "resetsAt": "..." },
    "monthly": { "status": "ok", "percent": 6,  "resetsAt": "..." }
  }
}

The endpoint returns used percentages. The plugin displays remaining = 100 - percent.

Plugin structure

Visibility condition

The web client reads the current session's selected provider via modelDirectories:

• provider is opencode-go, or any route key derived from it (opencode-go-*, e.g. a custom opencode-go-extra route serving models the installed pi-ai catalog has not shipped yet) → show the icon
• any other provider → hide the icon

The host half applies the same rule when it checks Settings → Models, so a derived route reports real quota instead of not-in-models.

The host reads that catalog through the settings service's current surface (describe() on dsh >= 0.2, the older get(ns) before it). A settings surface the plugin cannot read at all leaves the verdict undetermined and it proceeds to the request rather than reporting not-in-models: the icon is already gated on the session's live provider, so refusing there would only replace a real request with a misleading message.

Since v0.2.0 the client declares modelDirectories in its inject list, so activation waits for the model-selection service before registering the icon. Without that declaration, dsh >= 0.1.3 (which activates client rows as their injected services resolve) could run apply before the service exists and silently never show the icon.

Known limitations

• The usage endpoint is undocumented and may change in the future.
• The endpoint only returns percentages, not dollar amounts; the plugin shows percentages and reset times.
• The cache is global: the same OpenCode Go account shares the same quota across sessions.

License

MIT

---

中文说明