Skip to content
  • Home
  • Plugin manual
  • dsh-quota-panel

brittanistrehlowll-oss/dsh-quota-panel

40Last commit Aug 14, 2026

dsh-quota-panel DSH plugin

This plugin registers a server-side proxy route for each configured provider, resolving API keys via the credentials seam without exposing them to the browser. It injects a Harness-native status widget (bottom-right) that displays quota/balance information in a collapsed capsule (minimal glanceable dot+value) or an expanded card with full details, progress bars, and auto-refresh.

ui-productivity

How to install the dsh-quota-panel DSH plugin

dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-quota-panel

Copying does not run this command. Review the repository and version before installing the dsh-quota-panel DSH plugin.

dsh-quota-panel DSH plugin data source

dsh-quota-panel DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-quota-panel DSH plugin can do

  • Registers server-side proxy routes `/api/quota/<id>` for each provider, keeping API keys server-side.
  • Injects a Harness-native widget with two sizes: collapsed capsule (per-account status dot + value) and expanded card (structured rows with progress bars).
  • Auto-refreshes data at a configurable interval (default 60s), paused when the page is hidden.
  • Uses Harness design tokens (`--dsw-alias-*`, `--dsw-static-*`, etc.) to follow the product theme (light/dark) without custom palette.
  • Supports two built-in renderer formats: `deepseek-balance` (balance display with tiers) and `opencode-usage` (usage percentage with progress bars).
  • Configurable per-provider: refresh interval, balance tiers, usage warning/error thresholds, and custom labels.

Where the dsh-quota-panel DSH plugin fits

  • Monitor DeepSeek account balance and replenishment status directly from the DSH web interface.
  • Track OpenCode usage quotas (rolling, weekly, monthly) with visual progress bars.
  • Quickly view multiple provider quota/balance states in a compact capsule without leaving the page.
  • Get alerted when a provider's balance is low or usage is high via color-coded status dots (green/amber/red).
  • Manage API keys centrally through the DSH credentials seam, avoiding browser exposure.

Who the dsh-quota-panel DSH plugin is for

  • Developers using DSH who need to monitor API provider quotas and balances.
  • Teams managing multiple DeepSeek or OpenCode accounts and wanting a unified status view.

dsh-quota-panel DSH plugin limitations

  • Only works within the DSH web surface (requires `dsh web` to be running).
  • Currently supports only two renderer formats: `deepseek-balance` and `opencode-usage`; other quota APIs require custom configuration or future format additions.
  • Each provider must be manually configured with its own credential reference and endpoint URL.
  • The widget is injected into the page and may not be visible if the DSH web surface is modified or if there are layout conflicts.

dsh-quota-panel DSH plugin: from the repository README

Quoted from the brittanistrehlowll-oss/dsh-quota-panel README, the upstream source of the dsh-quota-panel DSH plugin. Copyright remains with the original authors.

English | [中文](README.zh.md) Provider quota / balance status widget for the **dsh web surface** (DeepSeek Harness). A zero-dependency host plugin: for every configured provider it registers one server-side proxy route `/api/quota/<id>` — the API key is resolved through the credentials seam and **never reaches the browser** — then injects a small Harness-native status widget (bottom-right) with two sizes: - **Collapsed (default)** — a minimal glanceable capsule: one independent "status dot + value" pair per account (e.g. `● ¥58.36 · ● 45%`), no text labels — only the affected account's dot changes color. Click to expand. - **Expanded** — the full card: "模型额度" header with refresh/collapse buttons, then one structured row per provider (status dot, name, primary value, secondary line, progress bar for usage-style providers). The collapse button shrinks it back. Both sizes auto-refresh (paused while the page is hidden; the refresh button spins while a manual refresh runs and re-entrant clicks are ignored). In the capsule, usage percentages are battery-colored (green when healthy, amber when tight, red when critical), matching their independent dot; balance values are tint

Read the full READMERepository license: MIT

dsh-quota-panel DSH plugin questions

How do I install dsh-quota-panel?

Run `dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-quota-panel"` and then restart `dsh web`. The plugin will be activated as a profile layer automatically.

How do I configure a new provider?

Edit your profile's `cordis.patch.yml` file. Add an entry under `providers` with the required fields: `id`, `label`, `credential`, `endpoint`, and `format`. See the Configuration section in the README for a full example.

Can I monitor multiple providers at once?

Yes, you can add multiple entries under `providers` in the configuration. Each provider will appear as a separate row in the expanded card, and the collapsed capsule will show all account statuses with independent dots.

Does the plugin expose my API keys?

No. The API keys are resolved server-side via `ctx.credentials` and the browser only contacts `/api/quota/<id>` on your own DSH server. The response never contains the raw key.

The widget doesn't appear after installation. What should I check?

Ensure you have restarted `dsh web` after adding the plugin. Also verify that your `cordis.patch.yml` configuration for the plugin is correct and that the providers' endpoints are reachable from your DSH server.