dsh-codex-usage

When you delegate everyday coding, research, and test-running tasks to the official Codex subagent inside DeepSeek Harness, the ChatGPT Plus rolling windows of 5 hours, 7 days, and a month can be burned through before you notice. dsh-codex-usage closes that blind spot: it aggregates the used percentage and reset countdown for all three windows, together with your DeepSeek account balance (total, credits, and top-up, auto-selecting the currency with a positive balance), into a single read-only JSON endpoint so the companion UI panel only needs to render.

The entire capability lives in one GET /api/dsh-usage/overview. It reads account/read and account/rateLimits/read through a pinned @openai/codex app-server protocol, then calls the official DeepSeek /user/balance endpoint. A five-minute in-memory cache keeps upstream calls light, and ?refresh=1 forces a bypass. Security is baked in: the server accepts only loopback addresses (127.x, ::1, localhost) and rejects everything else with a 403; it never reads a request body or writes state; the DeepSeek API key is resolved through the DSH credentials service and is never written to disk or logs; Codex quota comes straight from the locally logged-in ~/.codex directory with no extra secret required.

It is built for developers who run DSH alongside the official Codex subagent (\u0040deepseek-ai/dsh-subagent-codex) to share token load, and who want a live dashboard to watch both quotas in real time. Pair it with the dsh-deepseek-usage floating panel and you get a glanceable view of 5-hour / 7-day / monthly window usage, reset countdowns, and DeepSeek balance — all without touching a single API key in the browser.