Back to directory

cvc-catalog-sync-plugin

Maintenance: Active

mikel38487/cvc-catalog-sync-plugin

DSH plugin: keeps the CheapVibeCode model catalog in the profile patch in sync with /v1/models and the official installer's reasoning levels, with a settings page

View on GitHubHomepage
$ dsh plugin add cvc-catalog-sync-plugin

Install

dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.

How installs work

0

stars

0

forks

JavaScript

Language

MIT

License

2026-11-20

Created

2026-11-20

Last push

README

CVC catalog, coefficients and balance

CI CodeQL downloads npm GitHub stars License: MIT

One plugin for three things a CheapVibeCode route needs in a DSH profile:

  1. Catalog sync keeps llm-pi-ai.providers.<provider>.models and the subagent model allowlist in step with GET /v1/models and with the reasoning levels published by the official CheapVibeCode installer.
  2. Coefficients put the price multiplier (×0.1 … ×10) beside every model of that provider in the model picker.
  3. Balance adds a sidebar button and a panel with the remaining balance and the spend since the previous reading.

Each of the three has its own switch in the settings page. A switched-off function leaves nothing behind: no route, no timer, no tool, no UI element. Version 2.0.0 replaces two earlier plugins (cvc-model-coeff-plugin and cvc-balance-plugin) and absorbs their features into this package, so one plugin row in the profile patch is enough.

Requirements

  • DeepSeek Harness >=0.2.2-rc.3 <0.4.0;
  • Node.js 20 or newer;
  • a provider route in llm-pi-ai whose baseURL points at a cheapvibecode.ru host (default https://ru.cheapvibecode.ru/v1), with its credential named by apiKeyEnv (default CVC_DEEPSEEK_API_KEY).

If there is no such route, the catalog and the balance have nobody to read: plan and apply report that no route was found, and the balance panel says so. The settings page itself still works, because it is also the switchboard.

Install

Ask the DSH agent to install the bundle from npm:

install the npm bundle cvc-catalog-sync-plugin

By hand: add "cvc-catalog-sync-plugin": "^2.0.0" to the dependencies of ~/.dsh/profiles/<profile>/package.json, add the package name to dsh.profile.bundles, and let the profile install it. The bundle ships a compiled client.js, so nothing is built during installation and no allowBuilds permission is needed. For a local checkout use "cvc-catalog-sync-plugin": "link:<absolute path>" instead.

The package keeps the name cvc-catalog-sync-plugin and the composition row id cvc-catalog-sync, so the profile does not need to be rewritten for the upgrade. See docs/UPGRADING.md for the steps that do change.

Where the settings are

The same form appears in two places:

  • Settings → CVC — a section of the settings navigation with its own icon (settings.section + settings.section.icon, id cvc, order 25);
  • Plugins → CVC catalog sync → bundle page — a configuration block between the bundle description and its component rows (plugins.bundle.config, keyed by the package name). In the collapsed list the block renders as a one-line summary.

One group of switches at the top (Features) and then the parameter groups: Catalog, Coefficients, Balance and Advanced. The switches decide which of the first three groups has any effect; the Advanced group holds the provider lookup (providers.*) and the level cache, and stays visible with every function off, because it configures the lookup all three share.

Switch What it controls
Catalog sync startup and timer runs, the cvc_catalog tool, POST /cvc/run and what the check and apply buttons can do
Coefficients GET /cvc/coefficients and the badges in the model picker
Balance GET /cvc/balance, the cvc_balance tool, the sidebar button and the panel

The settings page and GET /cvc/state are not gated: they exist with all three functions off, because the page is the switch. The check and apply buttons stay on the page when catalog sync is off, but the run route behind them answers 404 and the page reports the failed run.

A change is applied through PUT /cvc/config and takes effect immediately: the plugin declares every configuration field as volatile, so DSH reloads the row without a restart. Turning a function off unmounts it, turning it on mounts it again, in the same page session.

The three switches are named Catalog sync, Model coefficients and Balance, and the settings page spells out what a switched-off feature leaves behind: its route answers 404, its timer is not created, its interface element disappears. The page itself always stays, because it is the switch.

Buttons:

Button Effect
Save Validates the form and writes the row config into the profile patch through configEditor.edit(). A value equal to the schema defaults removes the override, so the patch keeps only real changes.
Check catalog Fetches the catalog and the level map, shows the diff, writes nothing.
Apply catalog Same fetch, then writes the models and the subagent allowlist. Asks for confirmation first.
Reset Puts the defaults into the form; press Save to remove the override.

Check and apply use the saved settings, so press Save first; the page marks unsaved changes. Below the buttons the page shows the last run: catalog, current and next model counts, the level source, added, removed and changed models, allowlist changes, warnings and the patch path.

Configuration

Read the full README on GitHub →

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.