DeepSeek Harness (DSH) adopts a plugin-based architecture. When using OpenCode Go, managing usage across multiple API keys often requires frequent page switching or checking the backend, leading to low efficiency. dsh-opencode-go-usage aims to solve this problem by integrating OpenCode Go subscription usage monitoring directly into the DSH Web interface.

Plugin Positioning

This is a DSH Web plugin maintained by mouseteamlucky. It provides a floating window that displays OpenCode Go subscription usage in real time, supporting usage bars, percentages, and reset countdowns for rolling, weekly, and monthly windows per key.

Core Features

  1. Floating window: A compact button fixed to the right edge displays the percentage of the most constrained window across all keys and blinks according to urgency (green/orange/red).
  2. Expanded panel: Each card displays usage details for one key, including a usage bar, percentage, reset countdown, and manual refresh button.
  3. Real-time refresh: The Host polls the official endpoint to fetch data, and the panel updates automatically.
  4. Automatic key pool discovery: Automatically reads the OPENCODE_GO_KEY_<name> configuration in $DSH_HOME/.credentials.yaml.
  5. Bilingual UI & DSH theme tokens: The interface supports switching between Chinese and English, and adapts to DSH light/dark themes.

Installation and Enablement

Add the plugin using the official installation command:

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

After installation, restart the DSH Web application (via launcher or protected path) and refresh the browser page for it to take effect.

Typical Usage

After enabling, a floating button appears on the right edge of the DSH Web interface. Click the button to expand the panel and view real-time usage for all keys. The panel automatically polls data and supports manual refresh.

Applicable Scenarios and Notes

This plugin is suitable for developers who need to manage multiple OpenCode Go keys simultaneously and want real-time usage monitoring.

On the technical implementation, the Host (Node ESM) is responsible for aggregating data, while the Client (browser) is responsible for presentation. Key data is not directly exposed to the browser. Dependencies include React, @deepseek-ai/cordis, @deepseek-ai/dsh-credentials, and @deepseek-ai/dsh-home-paths.

Note: The upstream fork belongs to @xiaweiliang060035/dsh-opencode-go-usage.

Summary

This plugin solves the pain point of multi-key usage monitoring through a floating component. For more details, refer to the catalog page or GitHub repository.