dsh-opencodego-usage

OpenCode Go subscription usage in the DeepSeek Harness composer. The 5-hour, weekly and monthly windows live in a compact pill between the permission and model controls; click it for a DSH-style details dialog with reset countdowns, colors and a manual refresh.

Zero configuration. The plugin uses the OpenCode Go provider key DSH already stores — no cookie, no workspace ID, no settings page.

Español

Screenshots from DSH Desktop on Windows 11. The chat background is blurred; the usage values are from the author's subscription.

What it does

• Shows the three OpenCode Go windows in one compact pill: 5-hour, weekly and monthly.
• Uses the same context-style rings as DSH's own context meter, with · separators between windows.
• Colors the ring and bar by severity: green below 50 %, amber from 50 % to 74 %, red from 75 % to 100 % (a rate-limited window is always red).
• Opens a native-looking details dialog on click: percentage, thin progress bar, reset countdown, local reset time, last update, auto-refresh cadence, data source and a Refresh button.
• Counts down every second while the dialog is open. When a reset reaches zero, it performs an automatic fresh read so the window resets without user action.
• Refreshes the percentages every 60 seconds and when the app window becomes visible again.
• Appears only while the active model belongs to the opencode-go provider. Other providers show nothing.
• Needs no settings: the provider key DSH already has is the only credential.

What it does not do

• It does not read OpenCode console cookies or scrape HTML.
• It does not ask for a key or store one in the plugin.
• It does not keep usage history, telemetry or local storage.
• It does not add tools, commands or changes to the agent.
• It does not show anything when the active model is not from OpenCode Go.

Why there are no settings

If an OpenCode Go model is selected, the provider is configured and its key is already available to DSH. The plugin resolves that key on the Host side and reads the official usage API. If no OpenCode Go model is selected, the plugin has nothing useful to show and renders nothing.

There is no plugin config file, no key input, no threshold editor and no refresh preference. It is what it is: the subscription data the provider already knows about.

Requirements

• DSH Desktop >= 0.2.1-rc.3 (tested on 0.2.1-rc.3, Windows 11).
• An OpenCode Go provider configured in Settings → Models, with a valid API key.
• Node 22+ (DSH ships its own runtime).

If the provider is not configured you cannot select one of its models, so the plugin never appears. That is intentional.

Install

From npm:

dsh plugin --profile desktop add @jamolpe88/dsh-opencodego-usage

From the repository:

dsh plugin --profile desktop add github:JaMoLpE88/dsh-opencodego-usage

From a local checkout, while developing:

dsh plugin --profile desktop add C:\path\to\dsh-opencodego-usage

Refresh the DSH window after installing. The pill appears in the composer of any session whose active model uses the opencode-go provider.

Usage

1. Select a model from the OpenCode Go provider.
2. The pill appears centered in the composer row, between the permission control and the model selector.
3. Click it to open the details dialog.
4. Use Refresh for an immediate read; otherwise the plugin refreshes every 60 seconds, when the window becomes visible again, and automatically when a reset reaches zero while the dialog is open.

Click outside the dialog, press Escape, or click the pill again to close it. Reset times are shown in the browser's local time zone, and the countdowns update every second without any action.

How it works

The Host half calls the official OpenCode Go endpoint with the provider key:

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

It returns the three windows:

{
  "usage": {
    "rolling": { "status": "ok", "percent": 4,  "resetsAt": "2026-10-25T13:31:58.000Z" },
    "weekly":  { "status": "ok", "percent": 24, "resetsAt": "2026-10-26T00:00:00.000Z" },
    "monthly": { "status": "ok", "percent": 12, "resetsAt": "2026-11-07T14:35:16.000Z" }
  }
}

• The key is resolved from DSH's credential service (OPENCODE_GO_API_KEY) on each read; OPENCODE_GO_API_KEY in the process environment is the fallback.
• Results are cached for 55 seconds so the 60-second poll and multiple windows share one upstream request.
• Upstream failures keep the last known percentages and mark them stale instead of blanking the pill.
• The browser half reads two same-origin routes: /api/opencodego-usage and /api/opencodego-usage/refresh. The key never reaches the browser.
• Visibility uses the live modelSelection projection. Switching to another provider hides the pill immediately; switching back shows it again.
• The Client formats reset timestamps with the browser's locale and time zone, re-renders the countdown every second while the dialog is open, and forces a fresh read when a countdown reaches zero (guarded so one reset cannot cause a refresh loop).

Privacy

• No cookies, no browser session scraping, no workspace ID.
• The API key never leaves the Host process: the browser receives only percentages and reset timestamps.
• No configuration file, no local storage, no telemetry, no third-party requests beyond the official usage endpoint.
• The Host does not log the key or include it in error messages.
• The screenshots above were taken from a real session with the chat background blurred for privacy.

See SECURITY.md for the short policy.

Troubleshooting

The pill does not appear. Check that the active model belongs to the OpenCode Go provider. The plugin intentionally renders nothing for other providers.

The pill shows a red dot and an error. Open the dialog for the code and hint:

Code	Meaning
missing-key	DSH has no OPENCODE_GO_API_KEY for this profile. Configure the OpenCode Go provider in Settings → Models.
invalid-key	The provider key was rejected (401). Re-check or replace it in Settings → Models.
no-subscription	The key has no active OpenCode Go subscription (403).
rate-limited	The usage API itself is rate limiting; try again shortly.
timeout / network	The Host could not reach opencode.ai; retry with Refresh.

The plugin has no settings of its own: provider problems are fixed in DSH's model settings.

Development

npm test        # node --test
npm run check   # syntax check for the Host and Client files

The tests cover the API parser, HTTP error mapping, the cache, the missing-key path and the stale-data fallback. The Client half is a plain client.js bundle (no build step) and is verified in the running Harness.

Local install:

dsh plugin --profile desktop add C:\path\to\dsh-opencodego-usage

Third-party marks

OpenCode and the OpenCode logo are trademarks of their respective owner. The logo is used only to identify the OpenCode Go service; it is not covered by the MIT license that applies to the source code. See NOTICE.

License

MIT © 2026 JaMoLpE88