Back to directory

dsh-desktop

Maintenance: Active

bruc3van/dsh-desktop

Independent desktop client for DeepSeek Harness — official Web UI untouched, long-running tasks live in the tray, curated plugins reviewed before install.

View on GitHubHomepage
$ dsh plugin add dsh-desktop

93

stars

17

forks

TypeScript

Language

MIT

License

2026-08-12

Created

2026-10-03

Last push

MIT-licensed, community-maintained non-official desktop client that wraps DeepSeek Harness natively — it bundles the official dsh runtime and drives it via the public `dsh web` CLI / `/api` protocol, with tray-resident long tasks, a review-before-install safe marketplace, and smart-mode reuse of your existing instance. The packaged app needs no Node.js or CLI setup.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-28

License

MIT

01What can it help you accomplish?

  • Run DeepSeek Harness as a persistent desktop app — long tasks keep running after the window closes

    Official Web UI in a desktop window with tray / menu-bar residency, a background Harness service, controlled restart on unexpected exit and auto-recovery after system wake

    DeepSeek Harness (dsh) users who delegate long-running tasks and don't want them bound to a terminal or browser tab

  • Discover and install dsh plugins through a review-before-install safe marketplace

    600+ curated plugins in the built-in marketplace: catalog auto-collected daily with human curation; the agent reads the code first and installation runs via the official command only after you confirm it is clean

    dsh users who want plugins but want to verify what they install is safe before it runs on their machine

  • Reuse your existing dsh instance and shell environment

    Smart mode reuses the instance on 127.0.0.1:3080, PATH `dsh` or the npx cache, sharing `~/.dsh` sessions with CLI and browser; agents run in your full shell environment

    Developers who already run `dsh web` or the CLI and want one shared Harness process across terminal, browser and desktop

02How to install into DeepSeek Harness

Prerequisites

  • Packaged release ships a pinned official `@deepseek-ai/dsh` runtime — Node.js, pnpm and the `dsh` CLI are not required
  • Current installers are not yet formally developer-signed; first launch may show a system warning (macOS/Windows bypass steps in the README)

Installation steps

  1. 01

    Download the installer for your OS from GitHub Releases and launch it

  2. 02

    On first launch, add an API Key in the onboarding flow (or choose 'configure later' and complete it in Settings → Models → DeepSeek)

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationNative runtime

Dedicated desktop client for DeepSeek Harness: bundles a pinned official `@deepseek-ai/dsh` runtime, drives it through the public `dsh web` CLI / `/api` protocol, and reuses your running instance, PATH `dsh` or npx cache in smart mode

  • Long-running tasks in the tray

    delegated long-running Harness tasks→Harness service keeps running in the background after the window closes; tray / menu-bar icon reopens it on click; controlled restart and auto-recovery after system wake

    the app stays resident in the system tray / macOS menu bar after the main window closes
  • Governed agent execution environment

    agent commands inside the harness→agents reuse your PATH `dsh` and run in your full shell environment; `node`, `dsh`, `pnpm` are always available under the bundled runtime

    `ELECTRON_RUN_AS_NODE` is stripped from the agent environment so Electron-based tools like `code` keep workingthe bundled runtime directory does not provide `npm`/`npx`
  • Safe marketplace — review before install

    dsh plugins from the curated 600+ catalog→a security-review prompt is handed to the Agent, which reads the repo code; installation runs via the official command only after you confirm it is clean

    the marketplace is off by default and only contacts the network after you enable itsafe install never executes any install command on your behalf
  • Smart mode — reuse a running instance

    an existing official instance on 127.0.0.1:3080, PATH `dsh`, or the npx-cached package→browser, CLI and desktop share the same Harness process with session state synced in real time

    smart mode only uses what already exists on your machine — no network fetch, no downloads, no Node.js install
  • Verified in-app updates

    a new version published on GitHub Releases→installer is downloaded, SHA-256 verified, then the installer is launched; the local runtime is preserved if download or verification fails

    release builds check for updates about 4 seconds after launch, with no repeated auto-check within 12 hours

04Who is it for? When not to use it?

Good for

  • DeepSeek Harness (dsh) users who delegate long-running tasks and don't want them bound to a terminal or browser tab
  • dsh users who want plugins but want to verify what they install is safe before it runs on their machine
  • Developers who already run `dsh web` or the CLI and want one shared Harness process across terminal, browser and desktop

Not for

  • Current installers are not yet formally developer-signed: macOS may block first launch (right-click open or `xattr -dr com.apple.quarantine`), and Windows SmartScreen requires 'Run anyway'.
  • The app does not enable App Sandbox, so agents have the same file read/write permissions as a normal user process.
  • Official dsh is currently local-only: it defaults to listening on 127.0.0.1, and a network-exposed 0.0.0.0 binding is explicitly rejected (remote code execution risk); remote or container instances are not an officially supported scenario.

05Compatibility, maintenance and safety notes

  • Current installers are not yet formally developer-signed: macOS may block first launch (right-click open or `xattr -dr com.apple.quarantine`), and Windows SmartScreen requires 'Run anyway'.
  • The app does not enable App Sandbox, so agents have the same file read/write permissions as a normal user process.
  • Official dsh is currently local-only: it defaults to listening on 127.0.0.1, and a network-exposed 0.0.0.0 binding is explicitly rejected (remote code execution risk); remote or container instances are not an officially supported scenario.
  • The bundled runtime directory provides no `npm`/`npx` — for scenarios that need them (e.g. starting MCP servers via `npx`), install Node.js yourself or switch to fixed-address mode.
  • macOS notification center requires a valid code signature, so the current ad-hoc signed builds downgrade Web Notifications to a Dock badge, Dock bounce and clickable in-app alerts.
2026-08-122026-08-24v0.3.2

MIT · actively maintained (latest release v0.3.2, 2026-08-22)

06Frequently asked questions

Do I need to install Node.js or the dsh CLI to use DSH Desktop?

No. The release installer bundles a pinned official `@deepseek-ai/dsh` runtime — ordinary users don't need to install Node.js, pnpm or the dsh CLI; double-click and it works. Smart mode also only reuses what already exists on your machine (PATH `dsh`, the npx cache, or your running instance) — no network fetch, no downloads, no Node.js install.

Will my long tasks keep running when I close the window?

Yes. Closing the window does not interrupt the task: the app stays resident in the tray / menu bar, the Harness service keeps running in the background and reopens on click; unexpected local exits get a controlled restart, and pages that misbehave after system wake or long background time auto-reload once the service is confirmed reachable.

How does the built-in safe marketplace review plugins before install?

The marketplace is off by default and only goes online once you enable it. 'Safe install' never executes any install command for you: it puts a security-review prompt into a new session's input box (unsent), the Agent actually reads the repo code, and only after you confirm it is clean does it install via the official command `dsh plugin --profile web add`.

What's the difference between Smart mode and fixed-address mode?

Smart mode probes in order: the official instance on 127.0.0.1:3080 → PATH `dsh` → npx cache → the bundled runtime, and shares one Harness process across browser, CLI and desktop with real-time session sync. Fixed-address mode connects straight to a Web UI address you maintain — the client starts no runtime at all, so the runtime version, plugins and environment are entirely yours.

Is the marketplace catalog human-curated?

Yes. The catalog is auto-collected daily with human curation: the daily snapshot pipeline crawls repos tagged `dsh-plugin`, requires a description, drops archived/disabled projects, then applies a `curated.json` manual exclusion list with balanced category distribution. Being listed is not a security endorsement — review before you install.

08Data and sources

  • Author-claimedgithub.com0237d5cea02e…

    DSH Desktop 是一个独立的 DeepSeek Harness(`dsh`)Electron 客户端。窗口里呈现的是官方 Web UI 本体——不是仿制版,官方产品什么样,窗口里就是什么样

  • Author-claimedgithub.com0237d5cea02e…

    发布安装包内置固定版本的官方 `@deepseek-ai/dsh` 运行时;普通用户无需另外安装 Node.js、pnpm 或 `dsh` CLI。

  • Author-claimedgithub.com0237d5cea02e…

    客户端只使用公开的 `dsh web` CLI 和 `/api` 协议,不修改官方仓库,也不依赖 Harness 私有内部包。

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.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.