Preface¶

If you regularly use OpenCodeGo through the DeepSeek Harness (DSH) Web GUI, the remaining quota usually needs to be checked separately. dsh-opencodego-usage integrates this information into the DSH Web GUI: it displays a breathing indicator light at the bottom-right corner of the chat input box. Clicking it expands a panel to view the usage, remaining ratio, and reset time for the rolling, weekly, and monthly windows.

What This Is¶

BeiZi6/dsh-opencodego-usage is a plugin for the DeepSeek Harness (DSH) Web GUI that provides OpenCodeGo remaining quota monitoring. The repository owner is BeiZi6, and the author in package.json is Xu Yuanshan. It is designed for dsh web and is licensed under MIT © Xu Yuanshan.

Core Features¶

• Displays a breathing indicator light at the bottom-right corner of the chat input box, changing color based on the remaining quota ratio: green for >50%, yellow for 20–50%, and red for <20%, with a 3.6-second breathing animation.
• The indicator color reflects the lowest remaining quota ratio among the rolling, weekly, and monthly windows.
• Clicking the breathing light expands a liquid glass panel showing progress bars and reset times for the rolling, weekly, and monthly windows.
• Automatically reads the API key from DSH credentials; parses credentials specified by llm-pi-ai.providers.opencode-go.apiKeyEnv only when the active provider is opencode-go.
• Allows manual override of the API key for the current session within the panel; clearing it reverts to automatic parsing.
• Automatically refreshes OpenCodeGo quota every 2 minutes.
• The panel features mouse-follow highlighting, frosted blur, and a window-style diagonal opening animation.
• Registers a same-origin route /opencodego-usage on the DSH web server and queries the official OpenCodeGo quota API:

GET https://opencode.ai/zen/go/v1/usage

The request uses Bearer authentication.

Installation and Enabling¶

Before installation, the DeepSeek Harness web profile must be enabled. The runtime requires Node.js >= 22.19, with peer dependencies:

@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-host-webserver ^0.1.0-rc.6

Install from the official registry:

dsh plugin --profile web add github:BeiZi6/dsh-opencodego-usage

After installation, restart dsh web to activate the plugin.

To remove the plugin:

dsh plugin --profile web remove dsh-opencodego-usage

Typical Usage¶

1. Check the breathing indicator light at the bottom-right corner of the chat input box in the DSH Web GUI. The color indicates the current lowest remaining quota:

2. Click the breathing light to expand the panel and view the three windows:

• rolling: Approximately the last 5 hours
• weekly: Approximately the last 7 days
• monthly: Approximately the last 30 days

Each window displays usage, remaining ratio, and reset time.

3. If the current session requires using a different API key, enter a manual API key override in the panel. Clearing it reverts to automatic parsing.

4. The panel data refreshes automatically every 2 minutes, eliminating the need for manual repeated queries.

API Key and Status File¶

Manually overridden API keys are saved in a status file. By default, it is located under $DSH_HOME, and the path can be changed via the OCG_STATE_PATH environment variable. Deleting this file does not affect parsing based on DSH credentials.

API keys are only sent via HTTPS to the official OpenCodeGo quota endpoint.

Use Cases and Considerations¶

This plugin is suitable for scenarios where you use OpenCodeGo in the DSH Web GUI (dsh web) and want to quickly check the remaining quota directly in the chat interface.

Notes:

• The plugin runs with the permissions of the current dsh process. Before installation, you should review the source code and license.
• Quota values and reset times are displayed as returned by the OpenCodeGo API, without local estimation.
• The plugin registers a same-origin route /opencodego-usage on the DSH web server and queries the official OpenCodeGo quota API in the backend.
• Requires Node.js >= 22.19 and corresponding peer dependencies.

Conclusion¶

dsh-opencodego-usage integrates OpenCodeGo remaining quota into the DSH Web GUI, making it suitable for use cases where you need to quickly assess the rolling, weekly, and monthly quota status near the input box.

Repository: https://github.com/BeiZi6/dsh-opencodego-usage

If using the DSH community directory, you can search by the plugin name dsh-opencodego-usage.