DSH Plugins Marketplace

DSH Plugins

Plugins

/

Terminal & Clients

/

dsh-ollama-cloud-usage

A

dsh-ollama-cloud-usage

Manifest valid

DeepSeek Harness plugin: show Ollama Cloud remaining quota (session/weekly) as a Settings section beside Account & Balance, with an in-page API key editor. · DSH plugin: display the Ollama Cloud remaining quota below the "Account & Balance" section on the settings page, and allow entering the API Key directly on the page.

UI (client)hasBundlePatchMachine translated

dsh-ollama-cloud-usage

English | 中文

DeepSeek Harness plugin that shows the remaining Ollama Cloud quota as a Settings section, and lets you enter or replace the Ollama Cloud API key right on that page. The section registers as settings.section with id ollama-quota and order: -9, so it sits directly below the shipped Account / 账号与余额 entry. (The account page itself declares no child slot, so a plugin cannot append a card inside it; a sibling section is the supported placement.)

What it shows

RowSource field
Session window remaininglimits.session.usage (fraction in [0, 1])
Weekly window remaininglimits.weekly.usage
Per-model request countslimits.<window>.models[].request_count
Last-4-weeks cost and periodactivity.cost, activity.period
Key sourcewhich credential reference resolved
API key editorcredentials.describe / credentials.set / credentials.unset over the DSH Remote

Data comes from GET https://ollama.com/api/usage with Authorization: Bearer <key>. That is the endpoint behind the "Cloud usage" panel of ollama.com/settings; the local daemon at 127.0.0.1:11434 has no quota route. The response carries no plan label and no reset timestamps.

Install

From npm:

dsh plugin --profile <profile> add dsh-ollama-cloud-usage

From a checkout:

npm pack --pack-destination dist
dsh plugin --profile <profile> add "$(pwd)/dist/dsh-ollama-cloud-usage-0.2.0.tgz"

The install reconciles dsh.profile.bundles and the profile applies the new layer. If the Host row does not appear, restart the app; an updated Client half needs a page refresh (the Desktop app has no client-bundle watcher).

Custom API key

The section's API key card writes to the first credential reference in keyEnvs through the shipped credentials Remote — the same write path the Models settings section uses. Saving stores the key in $DSH_HOME/.credentials.yaml and immediately re-reads the quota; Clear removes it.

  • The card shows the reference name, whether it is configured, and the source layer (env, file, …).
  • A reference shadowed by a read-only source (a process environment variable) is reported read-only instead of silently writing to the fallback reference.
  • The key is never rendered back: the input is always empty, and the snapshot route returns no secret.
  • A client without the credentials Remote falls back to a manual-configuration hint.

Configuration

The plugin row reads these fields, all optional:

FieldDefaultMeaning
keyEnvs[OLLAMA_CLOUD_API_KEY, OLLAMA_API_KEY]credential references tried in order; the first is the one the editor writes
usageUrlhttps://ollama.com/api/usageusage endpoint
refreshMs60000snapshot refresh interval, minimum 5000
timeoutMs15000per-request timeout

Example profile patch entry:

- id: ollama-cloud-usage
  config:
    refreshMs: 120000

Credentials

The key is resolved through ctx.credentials, so it can live in the process environment, $DSH_HOME/.env, or the refs section of $DSH_HOME/.credentials.yaml:

version: 1
refs:
  OLLAMA_CLOUD_API_KEY: <key from https://ollama.com/settings/keys>

A missing key is not an error: the section renders the editor and a configuration hint. The key never reaches the browser — the snapshot route returns window fractions, request counts, the activity cost, the reference order, and error labels only.

Layout

FileRole
index.jsHost half: credential resolution, /api/usage polling, JSON snapshot route
client.jsClient half: the settings.section registration, quota UI, and key editor
cordis.patch.ymlbundle patch inserting the plugin row

Verification

node --check index.js && node --check client.js
node scripts/verify.mjs

scripts/verify.mjs drives both halves offline: the Host route paths (healthy, missing key, unauthorized, transport failure, credentials/updated refresh) and the Client component rendered against a hook-faithful React stub, including the key editor's describe/save/clear calls, the read-only branch, and locale switching.

Known Limitations and Deferred Work

  • ollama.com/api/usage is unofficial but stable; the payload carries no plan name and no reset timestamps, so the page shows window usage only.
  • The usage endpoint is polled and refreshed on credentials/updated; there is no push channel.
  • Only the first reference in keyEnvs is editable. Additional references remain configuration-only.

Comments

Loading…

Similar plugins

dsh-ollama-cloud

by Asheblog

Ollama Cloud provider for DeepSeek Harness: one-click provider setup with per-model reasoning-effort control and account usage in the Models page and sidebar.

Terminal & ClientsModels & ProvidersManifest valid

★ 4

MIT

TypeScript

Nov 14, 2026

dsh plugin --profile web add dsh-ollama-cloud

by Movingelated

DSH (DeepSeek Harness) plugin: delegate read-only collection tasks to a local Ollama model — zero cloud token cost, zero API key. 把只读采集任务交给本机 Ollama 模型:含设置面板 + 选型尺 + AI 可读说明书。

Models & ProvidersManifest valid

★ 3

MIT

JavaScript

Oct 1, 2026

dsh plugin --profile web add @local/dsh-localmodels-tokensavior

by AlienGene

DeepSeek Harness plugin for querying LLM service provider usage: reads each configured provider's remaining balance or subscription quota and shows it in an always-visible card in the web GUI

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Sep 12, 2026

dsh plugin --profile web add dsh-llm-balance

by shxiaooo

DeepSeek Harness web plugin: an ambient balance/usage reading under the composer, with a clickable per-provider detail panel. Every figure is upstream-reported.

Development & InfrastructureTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 14, 2026

dsh plugin --profile web add dsh-account-quota

by ruby1304

DeepSeek Harness web plugin: minimal quota/balance card — DeepSeek API balance with tier colors & peak/off-peak pricing pill, Kimi For Coding weekly + 5h windows with live reset countdowns. zh/en, loopback-only RPC, keys never leave the host.

Development & InfrastructureManifest valid

★ 0

MIT

TypeScript

Sep 10, 2026

dsh plugin --profile web add dsh-quota-status

by Andrew111888

A floating credit/quota widget for the DeepSeek Harness Web: shows DeepSeek / OpenCode Go balances and usage, and tracks DSH session token usage and estimated cost by day, month, and model.

UI & ExperienceManifest valid

★ 6

↓ 371/wk

BSD-3-Clause

JavaScript

Aug 26, 2026

dsh plugin --profile web add dsh-plugin-balance