Mars-Sea/dsh-commandcode-provider

Command Code provider plugin for DeepSeek Harness (dsh). Adds Command Code model access, live model catalog, plan-aware model selection, reasoning effort, image input, web search, and multi-account support.

dsh‑commandcode‑provider – What it is

dsh‑commandcode‑provider is an unofficial plugin that lets the DeepSeek Harness (the “dsh” UI framework for LLM‑powered agents) talk to the Command Code large‑language‑model service. It adds a new provider named commandcode that appears alongside DeepSeek’s built‑in models, letting you pick Command Code models, see usage quotas, and even run web‑search through Command Code’s API.

Why you might care

One‑click integration – Install the plugin with a single dsh plugin add command and the provider shows up in the model picker.
Full UI support – Both the web‑based dsh UI and the terminal‑only dsh‑TUI expose a Settings page where you can log in, manage multiple Command Code accounts, and toggle features (quota card, zero‑data‑retention, web‑search, etc.).
Multi‑account rotation – If you have several Command Code subscriptions, the plugin automatically switches to the next account when the current one hits its quota.
Plan‑aware model picker – Models are annotated with plan level, free/paid badges, image‑support, and reasoning‑effort options; out‑of‑plan models are hidden by default.
Cost estimates – Token counters show an approximate cost for each request based on the model’s published rate.
Vision support – Vision‑capable Command Code models accept images; an optional cache‑offload setting reduces repeated image‑cache charges.
Web search tool – The dsh web_search tool can be backed by Command Code’s /alpha/web‑search endpoint without extra keys.

How to get it running

Install (compatible with dsh 0.2.0‑rc.2 or 0.2.1‑alpha.1):
```
dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest
```
If you also use the terminal UI, repeat the install for the dsh‑tui profile.
Obtain a Command Code API key – either via the official command-code CLI (cmd login) or by clicking the Sign in to Command Code button in the Settings page.
Enter the key in Settings → Command Code (or set COMMANDCODE_API_KEY in your environment).
Pick a model – the new commandcode entry appears in the model selector, e.g.
```
/model commandcode/deepseek/deepseek-v4.1-flash
```
Start chatting – the provider works like any other LLM in dsh; you’ll see quota info, cost estimates, and (if enabled) image handling.

Key features at a glance

Feature	What it does	Where to control it
Plugin bundle	Registers a `commandcode` provider route with live model catalog.	`dsh plugin add`
Settings page	Manage API keys, account rotation, model visibility, privacy toggles.	UI → Settings → Command Code
Multi‑account rotation	Auto‑switches to next account when quota is exhausted.	Settings → Accounts card
Plan‑aware model picker	Hides models above your subscription tier; shows badges, context windows, image support.	Model picker UI
Reasoning‑effort levels	Exposes models that let you choose low/medium/high effort.	Model picker (if model supports)
Image input & cache offload	Vision models accept images; optional `offloadSeenImagesForCache` replaces old images with placeholders to avoid cache‑spikes.	Settings → Advanced
Quota card	Sidebar panel showing current 5‑hour and weekly usage, credit balance, reset timers.	Settings → Integrations & display → “Show quota card”
Session cost estimate	Approximate cost (`≈`) shown next to token counter.	Composer UI
Web‑search integration	`web_search` tool uses Command Code’s `/alpha/web-search` endpoint.	Settings → Command Code → “Serve dsh web search with Command Code”
Zero‑data‑retention (ZDR)	Sends `x‑cmd‑zdr: 1` header so prompts aren’t stored or used for training.	Settings → Privacy & security

Who should use it?

dsh users who want to experiment with Command Code’s models (including the latest DeepSeek‑based models) without leaving the dsh environment.
Teams with multiple Command Code subscriptions – the rotation logic saves you from manually swapping keys.
Developers needing vision – the plugin supports image‑capable models and offers a cache‑offload option to control cost.
Anyone who wants cost visibility – the built‑in cost estimate and quota card help keep usage predictable.

Limitations / gotchas

Only works with dsh 0.2.0‑rc.2 or 0.2.1‑alpha.1 – older dsh releases are unsupported.
pnpm 11 age‑gate – recent releases may be skipped when using @latest; pin the exact version if you need the newest build.
Zero‑data‑retention is off by default – you must enable it manually if privacy is a priority.
Cache‑offload is optional – turning it on changes how images are cached and may affect model behaviour.
Not an official Command Code product – you must provide your own API key and obey Command Code’s terms.

Quick reference commands

# Install for web UI
 dsh plugin --profile web add @mars-sea/dsh-commandcode-provider@latest

# Install for terminal UI
 dsh plugin --profile dsh-tui add @mars-sea/dsh-commandcode-provider@0.11.15

# Choose a model
 /model commandcode/deepseek/deepseek-v4.1-flash

# Show per‑account usage
 /commandcode   # or /commandcode status

In short: dsh‑commandcode‑provider is a community‑maintained bridge that brings Command Code’s LLM catalog, quota management, vision, and web‑search capabilities into the DeepSeek Harness ecosystem, with a rich UI and sensible defaults for multi‑account and cost‑aware usage.