beizi6/dsh-opencodego-usage
OpenCodeGo remaining quota monitor: breathing light in the lower right corner of the input box (green/yellow/red according to the remaining quota) + liquid glass panel (rolling/weekly/monthly window usage and reset time), automatically refreshed every 30 seconds, Key automatically reads DSH credentials (opencode-go provider) and can also be overridden manually
dsh-opencodego-usage is an OpenCodeGo quota monitor for the DeepSeek Harness Web GUI: a breathing indicator at the bottom-right of the input box (green >50%, yellow 20–50%, red <20%, 3.6s animation) shows remaining quota at a glance; clicking it opens a liquid-glass panel with per-window progress bars (rolling/weekly/monthly), used and remaining amounts, reset times, and a manual API key override. The indicator color reflects the lowest remaining share across the three windows; data refreshes automatically every 2 minutes.
Install
dsh plugin --profile web add github:BeiZi6/dsh-opencodego-usageGitHub source install per README (no npm package documented): dsh plugin --profile web add github:BeiZi6/dsh-opencodego-usage, then restart dsh web. Remove: dsh plugin --profile web remove dsh-opencodego-usage. Zero-config key handling: reads the API key from DSH credentials automatically (only when the active provider is opencode-go); an in-panel manual override is available (stored under $DSH_HOME, movable with OCG_STATE_PATH). The key is only ever sent to the official OpenCodeGo quota endpoint over HTTPS.
Compatibility
DeepSeek Harness Web GUI (dsh web), Node.js >= 22.19, peer deps @deepseek-ai/cordis (^4) and @deepseek-ai/dsh-host-webserver (^0.1.0-rc.6). Host half registers a same-origin route /opencodego-usage querying the official OpenCodeGo quota API (GET https://opencode.ai/zen/go/v1/usage, Bearer auth) with window data (rolling ≈ last 5 h, weekly ≈ last 7 d, monthly ≈ last 30 d, resetsAt); client half is a web-shell module in the conversation.input.right slot polling every 2 minutes. Older used/limit numeric pair shapes tolerated.
Details
- Repo: beizi6/dsh-opencodego-usage
- Category: Web UI Enhancements
- Stars: 6
- Version: GitHub source install github:BeiZi6/dsh-opencodego-usage (README-documented)
- Last push: 2026-08-14
- First seen: 2026-08-14
Recent updates
The current bilingual README (English primary) documents: features (breathing indicator, three-window panel, zero-config key handling, liquid-glass panel, auto-refresh), installation and removal, usage, API key resolution order (panel override → DSH credentials for opencode-go provider → process environment → state file), how it works (host route + client slot), known limitations, compatibility, and license (MIT).
FAQ
- How is the API key resolved?
- In order: a manual override entered in the panel (kept in a state file under $DSH_HOME), the DSH credential referenced by llm-pi-ai.providers.opencode-go.apiKeyEnv (only when the active provider is opencode-go), the process environment, then the state file.
- What do the three windows mean?
- rolling (≈ last 5 hours), weekly (≈ last 7 days), and monthly (≈ last 30 days). Each shows used percentage, remaining share, and the exact reset time reported by the OpenCodeGo API.
- Does the key ever go anywhere else?
- No — the key is only sent to the official OpenCodeGo quota endpoint over HTTPS (GET opencode.ai/zen/go/v1/usage with Bearer auth).
Alternatives
GLFzr-dsh-opencode-go-quota · Sev7een/ds-api-usage · qwert702/dsh-token-viewer