中文
The four Catppuccin flavors in DeepSeek Harness
Table of Contents
Intro
🐱 A Catppuccin theme plugin for
DeepSeek Harness — one
package that covers Web GUI (dsh web), DSH Desktop and
dsh-TUI:
- Web / Desktop: the whole UI re-skinned with the official 26-color
pastel palette — every component, not just a few accents.
- dsh-TUI: four official theme palettes auto-synced to
~/.dsh-tui/themes/ on install.
The four flavors — Latte, Frappé, Macchiato, Mocha — plug
into the built-in theme system on a level with the light/dark/system
choices, with a one-click switch row in Settings → General. Your choice
is saved automatically and restored on restart, and switching back to
Default restores the built-in appearance pixel-perfectly — no leftovers.
Features
- 🎨 Full palette coverage — every value is a Catppuccin palette color
(or a mix of palette colors); the default DeepSeek blue-gray never shows
through.
- 🖱️ Component-level accents — message bubbles, tool-call rows, code
tags, timestamps and hover interactions are tinted from the palette; hover
glows in the theme accent, and the empty-workspace headline reads in
brand mauve.
- 💻 dsh-TUI themes — one install command drops the four themes into
your terminal client; they auto-sync on every start. See
Install · dsh-TUI.
- 🔄 Update check — Settings silently checks npm for a newer release
(with a manual button too) and shows a copyable upgrade command.
- 🧠 Choice remembered — persisted across restarts and re-applied even
when the host re-asserts its own preference; turning it off restores the
built-in light/dark choice you had before, not a forced "system".
- 🗄️ Durable state — flavor choice survives DSH Desktop's random
per-launch port where browser localStorage starts empty.
- ⚙️ Zero intrusion — switching to Default restores the built-in
appearance pixel-identical; uninstall leaves nothing behind.
Previews
The four flavors in DeepSeek Harness (headline image above is the
catwalk composite; each flavor below in full):
🌻 Latte
View image
🪴 Frappé
View image
🌺 Macchiato
View image
🌿 Mocha
View image
Install
From GitHub (recommended — always the latest):
dsh plugin --profile web add github:zhijun-dai/Catppuccin-dsh-theme
From npm:
dsh plugin --profile web add dsh-catppuccin
💡 The npm release may lag slightly behind GitHub. For the very latest,
use the GitHub install above (pin a branch with #branch-name).
For DSH Desktop, target the desktop profile:
dsh plugin --profile desktop add dsh-catppuccin
dsh-TUI (terminal themes)
The same package also syncs the four Catppuccin themes into your dsh-TUI.
Install into the TUI profile and they land on the first start:
dsh plugin --profile dsh-tui add dsh-catppuccin
Then pick a theme inside the TUI: /theme catppuccin-mocha.
💡 Installed into a web/desktop profile of a user who also runs dsh-TUI,
the themes stay in sync on every web start — no second install needed.
No ~/.dsh-tui on disk? Strict no-op, nothing is created.
Restart the web server afterwards:
dsh web
Usage
Open the web UI, go to Settings → General, and pick one of the four
Catppuccin flavors (or Default to follow the built-in appearance).
Choice is saved per browser and restored at boot.
FAQ
Q: Web UI fails to boot with “Failed to load plugins / dsh-catppuccin”.
Older packages require @deepseek-ai/dsh-client-runtime, which newer DSH
client module tables no longer expose. The fix is included in 0.2.5 and
later (issue #3).
If npm still serves an older release, install the current GitHub version:
dsh plugin --profile web add github:zhijun-dai/Catppuccin-dsh-theme
Use --profile desktop for DSH Desktop, then restart the corresponding app.
Q: I installed the plugin but don't see the themes in Settings.
Make sure the profile you installed into is the one dsh web runs
(--profile web above), and restart dsh web after installing.
Q: How is my choice remembered?
It lives in browser localStorage (instant) and, for Desktop users, in a
small durable file under $DSH_HOME — so it survives restarts, model
switches and Desktop's per-launch port changes. Your explicit
light/dark/system pick in the built-in Appearance row always wins.
Q: How do I upgrade?
Re-run the install command (it fetches the newest release), or check the
Settings row — it silently tells you when a newer version exists and shows
the copyable upgrade command. Then restart dsh web.
How it works
The theme definitions are generated from the official
catppuccin/palette palette.json
(never hand-edited). scripts/gen-themes.mjs maps the 26 Catppuccin colors
per flavor onto the --dsw-alias-* token directory from dsh's
@deepseek-ai/dsh-client-ui-theme stylesheets (including the --shiki-*
syntax palette and the leaked --dsw-static-deepseek-* static colors),
writes the per-flavor token tables to themes/, and embeds them into the
browser bundle lib/client.js. The dsh-TUI themes come from
scripts/gen-tui-themes.mjs.
💝 Thanks to
🏆 Listed on Awesome DSH Plugin
View image
Copyright © 2026-present zhijun-dai
