Catnap Studio

中文 | English

A cat-themed workspace suite for the DeepSeek Harness Web UI. It keeps the useful task, repository, file, statistics, and settings modules from the mature DSH Web UI ecosystem, then unifies them with original cat visuals. One install contains three appearances and an interactive desktop companion.

> A community project built on DeepSeek Harness. It is not an official DeepSeek product and is not endorsed by DeepSeek.

Current release line: Catnap Studio v0.3.3. Windows users who prefer a bundled experience can use the companion Catnap Desktop once it is published.

Included themes

• Warm Paper Den — cream paper, apricot controls, and a sleeping orange tabby.
• Moonlit Guardian — indigo night surfaces, gold stars, a guardian cat, and a lantern sleeper.
• Cat Atelier — recycled paper, blue/red annotations, workshop notes, and a peeking tuxedo cat.

Every cat illustration and paper texture is embedded in the browser bundle. The installed plugin makes no external image requests, and its theme layer does not touch model requests.

Workspace capabilities

• Theme switching in Settings — choose any of the three themes from large cards under Settings → General → Appearance. Desktop cats retreat while Settings is open and return when it closes.
• Cat Den Center — manage the companion and inspect enabled capabilities from one glass panel.
• Cat companion — drag, pet, feed, rename, hide, and recall it; affinity and position persist locally.
• Task board — organize tasks by status, open details, and schedule work.
• Git graph and files (fallback) — Catnap's embedded legacy workbench remains available when Better Sidebar is not installed.
• Better Sidebar workbench (optional) — file tree, editor, real terminal, Git diff, split right/bottom panels, and per-session layouts. When installed, Catnap automatically avoids activating the legacy Aion file panel and Git graph clients, preventing duplicate sidebars.
• Live statistics — inspect TPS, context, cache, and token usage.
• Plugin settings — manage workspace modules from DSH settings.

Task, fallback-workbench, statistics, and settings capabilities are composed from the compiled 0.1.12 code of public @linxin666/dsh-web-ui packages. Better Sidebar is an independent MIT-licensed plugin: Catnap only detects it through DSH and adapts its shared design tokens; it does not include Better Sidebar's terminal, filesystem, WebSocket, or node-pty code. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for notices.

Requirements

• Node.js ^22.19.0 or >=24
• pnpm 11.21.0
• DeepSeek Harness Web UI

If PowerShell cannot find dsh, install the CLI and open a new PowerShell window:

npm.cmd install -g @deepseek-ai/dsh
dsh --version

One-line npm install

dsh plugin --profile web add dsh-catnap-plugins@latest
dsh web

Restart dsh web after installation or upgrade.

Optional: Better Sidebar workbench

dsh plugin --profile web add dsh-better-sidebar@latest

Hard-refresh the browser after installing it. Catnap automatically avoids duplicate sidebars and themes Better Sidebar through the shared DSH tokens.

Install from a GitHub Release

1. Download the matching .tgz from Releases. 2. Install the plugin in PowerShell:

dsh plugin --profile web add "C:\path\to\dsh-catnap-plugins-0.3.2.tgz"

3. Start or restart the DSH Web UI:

dsh web

Restart dsh web after installation or upgrade. Remove the plugin with:

dsh plugin --profile web remove dsh-catnap-plugins

Install from source

git clone https://github.com/luoyan96/dsh-catnap-studio.git
cd dsh-catnap-studio
pnpm install
pnpm run ci
dsh plugin --profile web add link:$(pwd)
dsh web

On Windows PowerShell, use this link command:

dsh plugin --profile web add "link:$($PWD.Path)"
dsh web

If the all-in-one reference bundle is already installed, remove it first to avoid registering the same functional modules twice:

dsh plugin --profile web remove @linxin666/dsh-web-ui-all

Release packages

Pushing a tag matching package.json (for example v0.3.2) runs the Release workflow and uploads dsh-catnap-plugins-0.3.2.tgz with CHECKSUMS.txt. Verify the SHA-256 before installing.

Development

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run pack:check

Start the local preview with python -m http.server 4173, then open http://127.0.0.1:4173/preview/index.html?theme=warm. The theme query accepts warm, moonlit, or atelier; append &state=active for the Cat Atelier active-session example.

Current real-DSH acceptance captures are in [docs/qa/](docs/qa/). See [DESIGN.md](DESIGN.md) for theme constraints, [design-qa.md](design-qa.md) for visual acceptance evidence, [CONTRIBUTING.md](CONTRIBUTING.md) before contributing, and [SECURITY.md](SECURITY.md) for security reporting.

License

Catnap Studio's own code and artwork use [BSD-3-Clause](LICENSE). The embedded UI modules declare Apache-2.0 in their npm manifests while their tarballs also carry BSD-3-Clause text; this repository preserves both. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).