dsh-ai-quota

A DeepSeek Harness plugin that shows your AI subscription quotas & balances — Codex, Kimi, DeepSeek, 302.AI, OpenCode Go — in one place.

English · 中文

Preview

Settings page: per-window usage bars (Codex / Kimi / OpenCode Go) and plain balances (DeepSeek, 302.AI), with manual refresh and a composer chip that follows the selected model.

Features

• Model tool query_ai_quota — ask any agent session to check your quota; returns a human-readable summary.
• Settings page — an "AI Quota" section with per-window usage bars and balances, plus manual refresh.
• Composer chip — a one-line quota indicator that follows the selected model, on both the new-chat page and in sessions.
• Auto-refresh — the host re-queries all providers every refreshIntervalMs (default 2 min; 0 disables) and serves a warm cache, so every surface reads instantly.
• Unified format — providers are normalized to subscription windows or balance entries; one provider failing never affects the others.
• No secrets in output — API keys and tokens never appear in tool output or logs.

Install

dsh plugin --profile web add github:Carrick-K7/dsh-ai-quota

The bundled cordis.patch.yml declaration makes dsh plugin append the plugin row to dsh.profile.bundles automatically. Restart dsh web afterwards (pnpm must be on PATH).

Configuration

All keys optional, defaults shown.

Key	Default	Meaning
timeoutMs	15000	Per-provider query timeout (ms)
refreshIntervalMs	120000	Auto-refresh interval (ms); 0 = off
codexCli	codex	codex CLI command or absolute path
deepseekApiKeyEnv	DEEPSEEK_API_KEY	DSH credential ref (fallback: same-named env var)
opencodeGoApiKeyEnv	OPENCODE_GO_API_KEY	DSH credential ref (fallback: same-named env var)
ai302ApiKeyEnv	AI_302_API_KEY	DSH credential ref (fallback: same-named env var)
deepseekBaseUrl	https://api.deepseek.com	DeepSeek API base URL
opencodeBaseUrl	https://opencode.ai/zen/go/v1/usage	OpenCode Go usage endpoint
ai302BaseUrl	https://api.302.ai	302.AI API base URL
kimiBaseUrl	https://api.kimi.com/coding/v1	Kimi usage endpoint base (appends /usages)
kimiOauthHost	https://auth.kimi.com	Kimi OAuth refresh endpoint (appends /api/oauth/token)
kimiClientId	Kimi Code CLI's public client id	OAuth client_id (usually unchanged)

Credentials

• DeepSeek / 302.AI / OpenCode Go: key resolved through the DSH credentials seam first — apiKeyEnv is a credential ref (defaults DEEPSEEK_API_KEY / AI_302_API_KEY / OPENCODE_GO_API_KEY), so a key stored in DSH (e.g. $DSH_HOME/.credentials.yaml) wins; a same-named process env var is the fallback for standalone deployments. OpenCode Go also falls back to the opencode-go entry in ~/.local/share/opencode/auth.json.
• Codex / Kimi: no keys — the local CLI login state is reused (codex CLI on PATH; Kimi Code CLI's OAuth session, auto-refreshed when expired, kimi login again if it is gone).

Data sources

Provider	Source
Codex	Local codex app-server --stdio JSON-RPC (account/rateLimits/read) — 5h / 7d windows
Kimi	GET {kimiBaseUrl}/usages (Kimi Code CLI's OAuth login state)
DeepSeek	GET {deepseekBaseUrl}/user/balance (bearer key)
302.AI	GET {ai302BaseUrl}/dashboard/balance (bearer key)
OpenCode Go	GET {opencodeBaseUrl} (bearer key)

License

MIT