MIT-licensed local background tool that installs as a native dsh plugin for DeepSeek Harness (also supporting Codex Desktop): image/MP4 video backgrounds, saved themes, `/bg` commands and a Windows installer, with no DSH bundled.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-28
License
MIT
01What can it help you accomplish?
Put images, live wallpapers, MP4 videos or anime scenes behind the DeepSeek Harness web workspace
A background layer (image / dynamic wallpaper / MP4 video / anime) behind `dsh web`; code, inputs and buttons keep working
DeepSeek Harness (dsh) users who want their own visuals behind the workspace without losing usability
Switch or restore backgrounds from inside the DSH chat or sidebar
`/bg`, `/bg-theme`, `/bg-clear` slash commands or plain-language requests; saved-theme switching in the「背景」panel; last background restored on next launch
DSH users who prefer controlling the workspace via chat commands instead of a separate app
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness installed and `dsh web` available — the README says to install DSH yourself; beautiCode does not include, install or start it
- Node.js (the README says: 请先自己装好 DSH 和 Node.js)
- Optional: pnpm if you want DSH to install the npm package itself
Installation steps
- 01
Run `npx beauticode-dsh` — downloads the plugin from npm and writes it into your DSH profile (recommended)
$ npx beauticode-dsh
- 02
Start `dsh web` (or `npx @deepseek-ai/dsh web` if `dsh` is not on PATH); the「背景」panel appears in the sidebar above Settings
$ dsh web
- 03
With pnpm: run `npx @deepseek-ai/dsh plugin --profile web add beauticode-dsh`, then `npx @deepseek-ai/dsh web`
$ npx @deepseek-ai/dsh plugin --profile web add beauticode-dsh
- 04
Windows installer: it bundles Node.js and auto-writes the DSH plugin when installation finishes; if that fails, run `dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integrations\deepseek-harness`
$ dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integrations\deepseek-harness
Verify the integration
Not specified by the author
Rollback
- Run `npx beauticode-dsh --remove` to uninstall the plugin
03DSH integration and capability boundaries
Installed as a first-class dsh plugin: `npx beauticode-dsh` (or `npx @deepseek-ai/dsh plugin --profile web add beauticode-dsh`) writes the plugin into your DSH profile; the DSH web sidebar gains a「背景」panel and `/bg` slash commands
Image & video background layer
local image (JPG/JPEG/PNG/WebP) or MP4 video→background behind the DeepSeek Harness web page; code, inputs and buttons keep working
Chat & slash-command control
`/bg`, `/bg-theme`, `/bg-clear` or a plain-language request to the AI→sets a local image/video as background; switch saved themes; last background restored on next launch
Sidebar panel & tray management
DSH sidebar「背景」panel or the beautiCode tray menu→pick an image or MP4 from a folder, clear background, toggle sound, save/switch/delete themes
exiting the tray does not stop DeepSeek Harness, so ongoing work is not interrupted
04Who is it for? When not to use it?
Good for
- DeepSeek Harness (dsh) users who want their own visuals behind the workspace without losing usability
- DSH users who prefer controlling the workspace via chat commands instead of a separate app
05Compatibility, maintenance and safety notes
- Windows is the primary platform listed; supported hosts are DeepSeek Harness (recommended) and Codex Desktop, with JPG/JPEG/PNG/WebP images and MP4 video as media formats.
- The current Windows installer is not yet commercially code-signed, so Windows may show a SmartScreen prompt.
- User-imported images, videos and saved themes are stored in `%LOCALAPPDATA%\beautiCode`; the uninstaller keeps this data by default.
- beautiCode only reads locally-selected images and videos; it does not provide copyrighted content, so only import media you own or are allowed to use.
- beautiCode is an unofficial project with no affiliation or partnership with DeepSeek, OpenAI, Codex or other vendors; part of its media-handling approach adapts Codex Dream Skin.
MIT · actively maintained (latest release v1.0.1, 2026-08-23; last push 2026-08-26)
06Frequently asked questions
How do I install beautiCode for DeepSeek Harness?
Install DSH and Node.js yourself first, then run `npx beauticode-dsh`. It downloads the plugin from npm and writes it into your DSH profile — no pnpm and no extra `dsh plugin add` needed. Start `dsh web` and the「背景」panel appears in the sidebar above Settings.
Do I need pnpm or `dsh plugin add`?
No. `npx beauticode-dsh` writes the plugin into your DSH profile directly — the README explicitly says no pnpm and no further `dsh plugin add`. If you already have pnpm, DSH can install the npm package itself via `npx @deepseek-ai/dsh plugin --profile web add beauticode-dsh`.
Can I control backgrounds from the chat?
Yes. Use `/bg`, `/bg-theme`, `/bg-clear`, or just tell the AI to set a local image/video as the background. You can also pick an image or MP4 from a folder in the「背景」panel, clear the background, toggle sound, and switch saved themes; the last background is restored on the next launch.
What does the Windows installer do?
It bundles Node.js (no separate Node.js/npm/pnpm install) and automatically writes the DSH plugin when installation finishes; if that fails, add the integration manually with `dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integrations\deepseek-harness`. The installer is not code-signed yet, so Windows may show a SmartScreen prompt.
Is beautiCode official, and what happens to my data on uninstall?
No — it's an unofficial project with no affiliation or partnership with DeepSeek, OpenAI, Codex or other vendors. Uninstall with `npx beauticode-dsh --remove`. Your imported images, videos and saved themes live in `%LOCALAPPDATA%\beautiCode`, and the uninstaller keeps them by default.
07Related DSH workflows
dsh-web
by zhu1090093659
One-command install of a full DSH web workbench: monitoring HUD, task board, SSH panel, mobile remote, vision tool, git graph, skins, plugin manager.
petdex
by crafter-station
A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.
j-space-cognition-suite-v3.7
by tiger3807861189
AI cognitive-enhancement skills for agent harnesses inspired by Anthropic's global workspace research. Adds inference-time control and reasoning tools for DeepSeek Harness, Claude Code, Codex and OpenCode.
dsh-deep-whale
by small-tailqwq
DSH Web GUI 鲸鱼娘主题皮肤(深海女仆工坊 maid-atelier:亮/暗双模式)
08Data and sources
它不包含、不安装、也不启动 DSH。请先自行安装 DeepSeek Harness 并运行 `dsh web`。
`npx beauticode-dsh` 会从 npm 下载插件并写入你的 DSH profile,**不需要 pnpm,也不需要再执行 `dsh plugin add`**。
插件装好后,DSH 侧栏「设置」上方会出现「背景」,不必再开托盘。
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-28. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
