Back to directory

deepseek-harness-desktop

Maintenance: Active

chokwinlee/deepseek-harness-desktop

Compact DeepSeek Harness desktop host with a native SwiftUI iPhone Remote source preview.

View on GitHub
$ dsh plugin --profile web add github:owner/repo

244

stars

2

forks

Kotlin

Language

MIT

License

2026-08-14

Created

2026-09-11

Last push

MIT-licensed desktop shell that hosts the official DeepSeek Harness runtime in a window, bundles the rc.8 runtime, manages the Harness process automatically, and pairs native SwiftUI iPhone and Kotlin/Compose Android Remote apps over same-Wi-Fi or Tailscale HTTPS.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-27

License

MIT

01What can it help you accomplish?

  • Run the official DeepSeek Harness Web UI and runtime in a desktop window without installing Node.js or typing `dsh web` yourself

    A packaged desktop host (macOS under 90 MB with the complete Harness rc.8 runtime included, Windows 10/11 x64) that starts and stops the local runtime automatically

    DeepSeek Harness (dsh) users on macOS and Windows who want a ready-to-run, packaged host with the bundled Harness version shown in the sidebar

  • Continue a computer's DeepSeek Harness projects, sessions, and running tasks from a phone

    Native DSH Remote companions — SwiftUI iPhone client (TestFlight beta) and Kotlin/Compose Android client (signed APK) — paired over authenticated same-Wi-Fi or the user's own Tailscale network

    Users who want to browse projects, create sessions, steer tasks, handle approvals, send images, and follow subagents from iPhone or Android without moving execution off the computer

02How to install into DeepSeek Harness

Prerequisites

  • A supported desktop OS — macOS (Apple Silicon arm64 / Intel x64 DMG) or Windows 10/11 x64 (EXE installer or portable ZIP) — downloaded from the latest stable GitHub Release
  • Android 8.0 or later plus the matching DSH Desktop build from the same release, for the Android Remote
  • An iPhone running iOS 17 or later and Apple's TestFlight app, for the iPhone Remote beta

Installation steps

  1. 01

    Install and open DSH Desktop.

  2. 02

    Open **Settings → Models** and configure a provider and API key.

  3. 03

    Add or select a workspace.

  4. 04

    Start a Harness session.

  5. 05

    To install a plugin, open **Settings → Plugins → Install & manage** and add an npm package, `github:owner/repo`, a public GitHub HTTPS URL, or a full command such as `dsh plugin --profile web add github:owner/repo`.

    $ dsh plugin --profile web add github:owner/repo

Verify the integration

  • Desktop parses supported install commands without running pasted text through a shell, then checks that Harness restarts successfully.

Rollback

  • If startup fails, it restores the previous plugin configuration.

03DSH integration and capability boundaries

DSH integrationNative runtime

Runs the official DeepSeek Harness Web UI and runtime in a desktop window (loopback-only `dsh web`); the Harness process is managed automatically, and plugins install through the official `dsh plugin` CLI sharing the same `DSH_HOME` as the CLI

  • Bundled ready-to-run Harness runtime

    the complete Harness rc.8 runtime shipped inside the packagea running Harness Web UI and runtime in a desktop window, with the bundled version shown in the sidebar

    no separate Node.js installation or terminal command is needed
  • Multimodal sessions

    images pasted or attached when the selected provider and model declare image input supportimages sent through the normal Harness conversation flow, remaining visible in session history

  • Usage insights on macOS

    the Harness session history on the local machinetoday and seven-day token totals, estimated cost, active task count, and aggregate running throughput

    cost figures are estimates derived from local token logs and available public model prices
  • Native mobile Remote (iPhone & Android)

    authenticated same-Wi-Fi pairing or the user's own Tailscale network (private Tailscale Serve HTTPS)browse projects, create sessions, steer tasks, handle approvals, send images, and follow subagents from iPhone or Android without moving execution off the computer

    direct same-Wi-Fi mode is authenticated but not encrypted — trusted private networks onlythe computer must remain online with Desktop and Harness running
  • Plugin management with recovery

    an npm package, `github:owner/repo`, a public GitHub HTTPS URL, or a full install commandplugin installed via Settings → Plugins → Install & manage or `dsh plugin --profile web add github:owner/repo`, with a verified Harness restart

    third-party plugins run code on the local machine — review their source and publisher before installation

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

Good for

  • DeepSeek Harness (dsh) users on macOS and Windows who want a ready-to-run, packaged host with the bundled Harness version shown in the sidebar
  • Users who want to browse projects, create sessions, steer tasks, handle approvals, send images, and follow subagents from iPhone or Android without moving execution off the computer

Not for

  • DSH Desktop is an independent community project, not an official DeepSeek AI product, and DeepSeek Harness itself is a developer preview that may introduce breaking changes.
  • Direct same-Wi-Fi Remote mode is authenticated but not encrypted, so it should only be used on a trusted private network; use private Tailscale Serve HTTPS for cellular, remote, or untrusted networks and never use Funnel.
  • Plugins installed through DSH Desktop run code on the local machine, so their source and publisher should be reviewed before installation.

05Compatibility, maintenance and safety notes

  • DSH Desktop is an independent community project, not an official DeepSeek AI product, and DeepSeek Harness itself is a developer preview that may introduce breaking changes.
  • Desktop ships for macOS (arm64/x64 DMG) and Windows 10/11 x64 (EXE/ZIP); the Android Remote requires Android 8.0 or later and is not yet on Google Play, and iOS builds are only available through the public TestFlight beta (iOS 17+).
  • Direct same-Wi-Fi Remote mode is authenticated but not encrypted, so it should only be used on a trusted private network; use private Tailscale Serve HTTPS for cellular, remote, or untrusted networks and never use Funnel.
  • Plugins installed through DSH Desktop run code on the local machine, so their source and publisher should be reviewed before installation.
2026-08-142026-08-24v0.4.1

MIT · actively maintained (latest release v0.4.1, 2026-08-24)

06Frequently asked questions

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

No — the desktop app manages the local Harness process automatically, so users do not need to install Node.js or start `dsh web` themselves. Configuration, workspaces, and sessions live in the same `DSH_HOME` used by the official CLI (`~/.dsh` by default).

Which platforms are supported, and where do I download it?

Desktop installers (macOS arm64/x64 DMG, Windows x64 EXE/ZIP) and the Android APK ship on the latest stable GitHub Release; iPhone builds are distributed through a public TestFlight beta. Android requires Android 8.0 or later, and iOS requires iOS 17 or later.

Is this an official DeepSeek AI product?

No — this is an independent community project, not an official DeepSeek AI product. DeepSeek Harness itself is a developer preview and may introduce breaking changes.

How do I install DeepSeek Harness plugins in DSH Desktop?

On macOS, open Settings → Plugins → Install & manage; the installer accepts an npm package, `github:owner/repo`, a public GitHub HTTPS URL, or a full command such as `dsh plugin --profile web add github:owner/repo`. Desktop checks that Harness restarts successfully, and if startup fails it restores the previous plugin configuration.

Is the Remote connection encrypted?

Use direct same-Wi-Fi mode only on a trusted private network: it is authenticated but not encrypted. Use private Tailscale Serve HTTPS for cellular, remote, or untrusted networks, and never use Funnel.

08Data and sources

  • Author-claimedgithub.comfbe6f2b920a3…

    DSH Desktop runs the official [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI and runtime in…

  • Author-claimedgithub.comfbe6f2b920a3…

    The desktop app manages the local Harness process automatically, so users do not need to install Node.js or start `dsh w…

  • Author-claimedgithub.comfbe6f2b920a3…

    loopback-only dsh web → official Harness UI/runtime

  • Author-claimedgithub.comfbe6f2b920a3…

    dsh plugin --profile web add github:owner/repo

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-27. 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.