Preface

The DeepSeek Harness (DSH) Web GUI comes with several official themes—light, dark, and system-following—using --dsw-* design tokens for color schemes. If you spend long hours looking at the interface during daily development or debugging agents, the default theme might not be easy on your eyes. The community has explored approaches like transparent UIs or custom CSS, but they often only modify parts of the interface or require maintaining styles yourself.

Below, we introduce dsh-catppuccin-theme (npm package name: @nonamelego/dsh-catppuccin), released by maintainer NoNameLeGo. It integrates Catppuccin’s four palettes—Latte, Frappé, Macchiato, and Mocha—into DSH’s official theme system, with an optional glassmorphism skin. The same package also covers Web GUI, dsh web, DSH Desktop, and dsh-TUI terminal colors.

What Is This

dsh-catppuccin-theme is a theme plugin for DeepSeek Harness, categorized as “Fun Customization.” Maintained by NoNameLeGo, its source code is hosted on GitHub. The current npm version is 0.4.0, licensed under MIT, with approximately 18 GitHub stars.

It solves two issues: first, it fully maps the interface to the Catppuccin palette (not just changing accent colors); second, it provides a toggleable, adjustable frosted glass skin in settings, where the top bar, sidebar, input fields, and other areas can display a glass-card effect, with colors automatically adapting to the current Catppuccin theme.

Core Features

Four Catppuccin Themes

The plugin includes Catppuccin’s four official themes:

  • Latte (light)
  • Frappé, Macchiato, Mocha (dark)

Integrated into DSH’s official theme system, these are on par with the built-in light/dark/system-following themes. Selections are saved locally and restored after restart. Choosing “System” reverts to the official theme preference from before Catppuccin was enabled, rather than forcing a reset.

Full Interface Color Mapping & Settings Entry

The plugin remaps the --dsw-* token hierarchy, covering major areas of the web interface. After installation and restart, a Catppuccin row will appear under Settings → General → Appearance, allowing one-click switching between the four themes.

Glassmorphism

Below the Catppuccin theme, there is a Glassmorphism setting:

  • Master Switch: When enabled, the top bar, sidebar, input fields, stats row, trace view, chat bubbles, and new session button become frosted glass; disabling it reverts to the native interface.
  • Mode: Mica Effect (floating frosted cards) or Compatibility Mode (keeps original layout, only changes material).
  • Presets: Clear, Standard, and Frosted options; you can also adjust glass blur (0–40 px), frosted intensity (0–100%), and background brightness.
  • Glass colors follow the current Catppuccin theme; gradient blur appears at the top and bottom edges of the page, and collapsing the sidebar reveals a floating glass effect.

dsh-TUI Terminal Theme

The same npm package includes TUI theme synchronization logic. After installation to the dsh-tui profile, it syncs the four theme JSONs to ~/.dsh-tui/themes/ (on Windows, %USERPROFILE%\.dsh-tui\themes\) at startup. Within dsh-TUI, you can use /theme to select Catppuccin Latte / Frappé / Macchiato / Mocha, or switch directly with /theme catppuccin-mocha.

Other Capabilities

  • Bilingual Chinese-English text, following system language.
  • Check Catppuccin Plugin Updates under Settings → General: Compares with the latest npm version and provides a copyable upgrade command when a new version is found (profile name auto-detected).
  • When installed for Web GUI and ~/.dsh-tui/themes/ already exists, Web startup also syncs TUI themes, typically eliminating the need for redundant installation.

Installation & Enabling

The plugin is installed per DSH profile. dsh plugin packages it into the corresponding profile’s bundles; after installation, restart the relevant process.

For the Web GUI targeting dsh web, run in the terminal:

dsh plugin --profile web add @nonamelego/dsh-catppuccin

After installation, restart dsh web. For other profiles, replace web in the command with the profile name (e.g., headless).

DSH Desktop

The default profile for the desktop version is desktop:

dsh plugin --profile desktop add @nonamelego/dsh-catppuccin

Run this in the DSH terminal; if a different profile is selected in the tray, replace it with the corresponding name. Restart DSH Desktop after installation for changes to take effect.

Installation from GitHub Repository

When npm is unavailable or you need to track source code:

dsh plugin --profile web add https://github.com/NoNameLeGo/dsh-catppuccin-theme

For Desktop, similarly replace web with desktop. When installing from git, if pnpm prompts about restricted build scripts, add the corresponding package to the profile’s pnpm-workspace.yaml under allowBuilds as prompted, then re-run.

dsh-TUI

dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin

Or:

dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-theme

After installation, start dsh --profile dsh-tui and use /theme to switch Catppuccin themes. You can also manually copy themes/*.json from the package to ~/.dsh-tui/themes/, but this won’t auto-update with versions; custom files renamed from catppuccin-*.json will be overwritten during sync—save them with different names if needed.

Typical Usage

Switching Catppuccin Themes

  1. Open the Web GUI (default: http://127.0.0.1:3080) or the desktop application in DSH Desktop.
  2. Go to Settings → General.
  3. Under Appearance, in the Catppuccin row, select Latte, Frappé, Macchiato, or Mocha.
  4. The interface changes color instantly; preferences are saved automatically and restored on next startup.

Enabling and Adjusting Glassmorphism

  1. Still in Settings → General, find Glassmorphism under Catppuccin theme.
  2. Toggle the master switch, then choose either Mica Effect or Compatibility Mode as needed.
  3. Start with the Clear / Standard / Frosted presets, then use the sliders to fine-tune blur, frosted intensity, and background brightness.
  4. When switching Catppuccin themes, the glass colors update accordingly; toggling the master switch returns to the native interface.

Checking for Plugin Updates

Click Check for Updates below Glassmorphism. If a new version is available on npm, the interface will display the version number and provide a copyable upgrade command; for local link: / file: / git installations, it will suggest using git pull or rebuilding.

Switching Themes in dsh-TUI

After installing the dsh-tui profile:

dsh --profile dsh-tui

Within the TUI, execute /theme and select from the Catppuccin series, or:

/theme catppuccin-mocha

TUI themes only affect the TUI’s internal colors; the terminal background remains determined by your terminal emulator. Pairing with Catppuccin terminal themes ensures a consistent look.

Use Cases & Notes

Who Is This For

  • Those who use DSH Web GUI or Desktop for extended periods and want a unified Catppuccin color scheme.
  • Those who need to quickly switch between light styles like Latte and dark styles like Mocha, with persistent preferences.
  • Those who like the frosted glass aesthetic but prefer not to maintain CSS or transparent UI plugins separately.
  • Those who also use dsh-TUI and want the terminal colors to match the same Catppuccin palette as the web interface.

Before Use, Please Note

  • DSH plugins run within the permissions and environment of the current dsh process. Before installation, review the GitHub repository source code and MIT license to ensure they meet your security and compliance requirements.
  • The community directory SkillHub Plugin Page is an independent site, with no official affiliation to DeepSeek / High-Flyer; installation commands should be based on the README and npm package.
  • If the Catppuccin row is not visible under Appearance, common reasons include the plugin not being correctly added to the profile bundles or the dsh web / Desktop process not being restarted; check dsh plugin list and profile configurations.
  • On the TUI side, catppuccin-*.json files are synced and overwritten by the plugin; for custom needs, save them with different filenames.

Conclusion

dsh-catppuccin-theme integrates Catppuccin’s four themes and optional glassmorphism into DSH’s official appearance system, covered by a single installation path for Web, Desktop, and TUI. If you’re looking for a “install and switch the entire color scheme, with adjustable frosted glass” theme plugin, you can start here.