🎨 DeepSeek Harness Themes

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 (into a DSH deployment)

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