Plugin directory / Developer / DSH-Decktop
DSH-Decktop
Verified · install-tested on dsh JustGenius-s
What it does
DSH-Decktop
Works — verified, early-stage project
DSH-Decktop It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
English ｜ 简体中文
DSH-Desktop
Electron desktop shell for DeepSeek Harness (DSH). Bundles node + pnpm, installs @deepseek-ai/dsh into ~/.dsh/runtime, and serves the dsh web UI in a browser window.
Download & Install
Prebuilt packages are published on GitHub Releases. First launch installs the DSH runtime (~1-2 min).
macOS
- Download
DSH-Desktop-*.dmgfrom the latest release. - Open the
.dmgand dragDSH-Desktop.appinto/Applications. - The app is unsigned, so Gatekeeper blocks the first launch. Right-click the app → Open and confirm, or run:
xattr -dr com.apple.quarantine /Applications/DSH-Desktop.app
Windows
- Download
DSH-Desktop Setup *.exe(installer) orDSH-Desktop-*-win.zip(portable) from the latest release. - Run the installer, or unzip the archive and launch
DSH-Desktop.exe. - The build is unsigned, so SmartScreen may warn. Click More info → Run anyway.
How it works
Electron main process
├─ bundled node + pnpm (resources/runtime; repo-root runtime/ in dev)
├─ first launch: pnpm installs @deepseek-ai/dsh → ~/.dsh/runtime (upgradeable)
├─ spawn dsh web --host 127.0.0.1 --port <free-port>
└─ BrowserWindow → http://127.0.0.1:<port>
DSH is installed from npm at runtime, not shipped with the app. Upgrading DSH = detect a newer version on launch → click "Update" → restart. No rebuild or re-signing.
Develop
pnpm install
pnpm collect # download node + pnpm into runtime/
pnpm start # first launch installs @deepseek-ai/dsh (~1-2 min)
Dev and packaged behave identically: both use the bundled node and the external ~/.dsh/runtime.
Package
pnpm dist:mac # macOS dmg + zip
pnpm dist:win # Windows nsis + zip (run on Windows)
macOS artifacts are unsigned; Gatekeeper blocks first launch. Allow with:
xattr -dr com.apple.quarantine /Applications/DSH-Desktop.app
Runtime dependencies
- node (latest) + pnpm (latest), bundled via
scripts/collect-runtime.mjs @deepseek-ai/dsh(npm latest), installed to~/.dsh/runtime
Desktop plugin API
The shell injects window.dshDesktop into the DSH page (updates / seats / notify). Plugins should depend on that contract, not on Electron packaging code. See docs/desktop-api.md.
Our plugins
Companion DSH plugins live in DSH-Plugs.
Thanks to
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install DSH-Decktop for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:JustGenius-s/DSH-DecktopHeadless (CLI) profile:
dsh plugin --profile headless add github:JustGenius-s/DSH-DecktopTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Extend the agent's coding surface — give it a new tool, workflow, or integration so it handles a dev task it couldn't before.
Who it's for
Developers who want dsh to behave like a teammate on real codebases — editing, running, and verifying changes rather than just answering.
For developers — extending it
The tool/command surface is the seam: expose more of the SDK, add smarter context wiring, or tighten the loop between code changes and verification.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/DSH-Decktop/)<a href="https://dshbase.com/plugins/DSH-Decktop/"><img src="https://dshbase.com/badges/DSH-Decktop.svg" alt="dshbase install-tested"></a>