@dsh-external/dsh-subscription-overlay
Manifest validToggleable DSH overlay showing quota windows (5h/7d/30d) for Claude, Codex, OpenCode Go and CommandCode.
dsh-subscription-overlay
Toggleable DSH web-overlay that aggregates subscription quota for Claude, Codex, and opencode-go (fresh OAuth/session fetches), plus a commandcode availability probe and a local monthly burn ledger.
Honesty rule: commandcode has no quota endpoint, so the card shows probe state (online/offline + latency) and local burn only — never a fabricated percentage. When no monthly budget is set, no percentage bar is rendered at all.
What it does
- Overlay floater (
shell.overlayslot, own plugin id — composites with the stockdsh-quotapill): draggable pill or ring mode, alert badge, click opens the 4-provider panel, staleness-triggered refresh. - 4-provider panel: per-window usage bars + reset times for claude (5h/7d), codex (primary/secondary), opencode-go (5h/7d/monthly); commandcode shows probe + burn only.
- Toggle:
Ctrl+Shift+Shotkey, settings-section switch, and host master switch. Hidden unmounts pill/ring and panel and stops polling. - Settings section (order 56, next to Task Router): master toggle, four
provider toggles, poll interval (1–60 min), alert threshold (1–100%),
commandcode monthly budget in tokens (
0= track only, no %). - Same-origin HTTP API (all POSTs require the
x-dsh-subscription-overlayCSRF header):GET /plugins/dsh-subscription-overlay/api/status→{ refreshedAt, providers[4], alertPct, overlay, enabled, settings }POST /plugins/dsh-subscription-overlay/api/refresh→ force re-fetchPOST /plugins/dsh-subscription-overlay/api/probe→ commandcode re-probePOST /plugins/dsh-subscription-overlay/api/settings→ validated patchPOST /plugins/dsh-subscription-overlay/api/ledger/append→{ model, tokens }fallback burn writer
Install
Prerequisites: DSH 0.1.5-rc.1 or later, Node 20+.
dsh plugin --profile web add C:/Projects/dsh-subscription-overlay
# restart the DSH web process once (bundle-list changes need a restart)
dsh --profile web --dump-config | grep dsh-subscription-overlay # loader row check
On the next web load the 订阅额度 pill appears (bottom-right, draggable).
Press Ctrl+Shift+S to hide/show it.
Usage
- Click the pill to open the panel; the refresh button forces a re-fetch.
- Settings → 订阅额度浮层: toggle providers, cadence, alert %, monthly budget.
- commandcode card: 探测 button re-probes
GET {baseURL}/models; 本月消耗 shows month-to-date tokens and (only when budget > 0) % of budget. - API keys never live in settings — credentials resolve via the DSH
credentials domain with env/session-file fallbacks (see
docs/SPIKE.md§2.1).
Screenshots
The overlay pill/panel render inside the running DSH web GUI after the
bundle loads (restart required after install). Screenshots will be added
here from a live session:
docs/screenshots/pill.png, docs/screenshots/panel.png,
docs/screenshots/settings.png.
Development
npm install
npm run typecheck # host
npm run typecheck:client # browser client
npm run build # tsdown → lib/index.js + lib/client.js
node --test tests/*.test.ts # 8 tests
Layout
src/index.ts— host: fresh-fetch aggregation, commandcode probe, burn ledger, settings validation, HTTP routes.src/client/— browser:SubscriptionPanel,OverlaySettingsSection,controller(snapshot store + API bridge),locale(zh/en),styles.docs/SPIKE.md— DSH/wezterm API spike (precedents + verdict).cordis.patch.yml+package.json#dsh— official profile-bundle install.
License
MIT — see LICENSE.
Comments
Loading…
From the same category
by kingcharleslzy-ai
Community-maintained dsh-purge fork with host-policy patches, prompt and rule settings, diagnostics, separate update-check and install controls, and local backup/rollback.
★ 10.7k
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add dsh-purge-communityby ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件:Claude Code 风,鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rol
★ 8k
↓ 19.2k/wk
MIT
TypeScript
Nov 20, 2026
dsh plugin --profile terminal add @deepseek-harness-tui/dsh-tuiby mmparko
DeepSeek Harness 破甲 (mirror of YuJunZhiXue/dsh-purge) — 上游即将删库,此为本仓库全量镜像:含全部分支/73 个 tag/完整提交历史。原作者署名与二开要求见 README 署名章节。
★ 5.5k
↓ 15.2k/wk
MIT
JavaScript
Oct 13, 2026
dsh plugin --profile web add dsh-purgeby bowenliang123
The best DeepSeek Harness plugin for context insight and management, with context dashboard / browser / sidebar and context command, for context statistics, composition, breakdown, evolution details,
★ 5.3k
↓ 116.3k/wk
Apache-2.0
TypeScript
Nov 19, 2026
dsh plugin --profile web add dsh-contextby strukto-ai
The World's First Virtual Terminal for AI Agents
★ 3.8k
↓ 513/wk
Apache-2.0
TypeScript
Nov 20, 2026
dsh plugin --profile agent add @struktoai/mirage-dshby c1overzz
DSH 插件:每天替你刷一轮 B站,读字幕挑出值得的、写一份日报,值得的 @ 你
★ 1.4k
↓ 9k/wk
MIT
JavaScript
Nov 12, 2026
dsh plugin --profile web add dsh-bili-scroll