🎨 DeepSeek Harness Themes

August 22, 2026 · View on GitHub

A selectable set of color themes for DeepSeek Harness (DSH).

It adds a Themes block to the General settings page, showing six theme cards — Tokyo Night, Catppuccin, Dracula, Gruvbox, Nord, One Dark — each with a live color preview. Click a card to apply the theme instantly; click another to switch. The palette is stacked as a token override layer so the app's backgrounds, surfaces, borders, brand/text colors, state colors, and sidebar retint together.

Features

  • Six themes with canonical palettes from the upstream projects: Tokyo Night, Catppuccin (Mocha), Dracula, Gruvbox (dark), Nord, One Dark.
  • Live preview cards in the General settings row — each card's swatch is drawn from that theme's literal colors, so it stays legible before/while the app is themed.
  • Instant apply: one click stacks a theme.overrideTokens layer; the selected card highlights and re-selecting another replaces the layer in place.
  • Undo / revert: the row applies themes on demand; stopping the plugin (or not selecting one) leaves the app on its default theme.

Install

The simplest way is with the DSH plugin CLI. Add the plugin to the default web profile:

dsh plugin --profile web add github:guillaumemeyer/dsh-themes

Note: web is the default profile, so it may be adjusted. Use --profile <name> to target a different profile (or a project-specific one), or omit --profile web to use the default. The CLI wires the plugin into the deployment's web-surface composition and rebuilds the browser bundle for you.

Manual install

Prefer to wire it by hand? This is a dsh.client browser plugin, so it must be installed and mounted where DSH composes its web surface (host/web composition), then the host restarted so the client-modules node half produces the bundle.

  1. Install the package into the DSH deployment's web app:

    npm i @guillaumemeyer/dsh-themes

  2. Find the web-surface (browser roster) composition. This is the cordis.yml / cordis.patch.yml in the DSH web app that lists the other browser roster rows (ui-settings-general, ui-theme, …). (The shipped @deepseek-ai/dsh-web-app cordis.patch.yml is the reference for this "browser plugin roster" section.)

  3. Add one row to that roster:

    - id: ui-themes
  name: '@guillaumemeyer/dsh-themes'

  4. Restart the DSH host. The @deepseek-ai/dsh-client-modules node half re-scans loader entries for packages declaring dsh.client, bundles /plugins/@guillaumemeyer/dsh-themes/client.js, and the browser loads it. (With a pnpm run dev:web watcher, the bundle is rebuilt automatically without a restart; in a production/built deployment a host restart is required.)

The row must live in the web-surface dsh.client roster (a dsh.client platform: "web" package). Placing it in an agent preset or a non-web composition will not be scanned into window.__DSH_BOOT__.

Verify it's mounted

After restart, the package's browser bundle is served under /plugins/@guillaumemeyer/dsh-themes/client.js, and the plugin appears in the settings.general.item slot.

Use it

  1. Open Settings (the gear at the sidebar foot).
  2. Open General.
  3. Under Themes, click a theme card to apply it. The app retints immediately and the card shows the selected ring.
  4. Click a different card to switch; the previous override is replaced in place.

Publishing updates

To publish a new version, ensure a local .env (untracked) holds your npm token, then:

cp .env.example .env   # once: edit to add NPM_TOKEN=...
npm run release        # runs publish:check (preversion), bumps patch, publishes to npm
  • The token is read from .env and referenced by the committed .npmrc via ${NPM_TOKEN}, so it is never tracked.
  • preversion runs node --check client.js && npm pack --dry-run automatically before the version bump.
  • The script is named release because publish is a reserved npm lifecycle name: npm auto-runs a publish script during npm publish. Naming it publish made npm publish re-run the script, bumping and publishing a version on every loop.

Notes

  • Client-only browser plugin; the node half (index.js) is an empty apply.
  • Selection is in-memory for the page session (the DSH client does not expose localStorage to plugin code, and a settings UI that applies a look doesn't need to persist it); the app returns to its default theme on reload until a card is clicked.
  • All six themes are dark palettes, so each maps the token override's light and dark slots to the same value — the theme fully defines its look in both OS schemes.
  • Package is published with publishConfig.access: "public"; .npmignore discards repo/dev cruft.

License

MIT