Introduction

The philosophy of dsh is “everything is a plugin,” and extension capabilities are usually attached to the dsh process as plugins. For scenarios where users are already using the dsh Web UI but want to use it as a desktop window, ahikl/dsh-desktop provides a desktop plugin: it wraps the dsh Web UI using Electron and provides a system tray and a custom title bar.

What is this

dsh-desktop is a desktop plugin for DeepSeek Harness maintained by ahikl. It is an out-of-tree plugin that does not modify the dsh source code and does not introduce Electron into the dsh dependency tree. The license is MIT.

Core Features

Below are several desktop capabilities.

  • Loads the dsh Web UI using Electron.
  • Borderless window + dsh-style title bar, automatically following the theme.
  • System tray: Show main window, open browser, quit.
  • Minimizes to tray when closing the window.
  • URL resolution priority: --url > Web Server port > Auto-start dsh web.

Installation and Usage

First, install the plugin, then run the desktop command:

dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop

If you want to explicitly specify the Web UI address, use --url:

dsh --profile desktop desktop --url http://127.0.0.1:3080

Versions 0.3.1 and below are deprecated; please use the latest version.

Typical Usage

When dsh-web-app is not installed, the desktop plugin will automatically launch the official Web UI:

dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop

When dsh-web-app is already installed, you can install the following combination and run:

dsh plugin --profile desktop add @ahikl/dsh-desktop @deepseek-ai/dsh-web-app electron
dsh --profile desktop desktop

After the steps above, the desktop client will resolve the target address in the order of --url, Web Server port, and auto-start dsh web.

Scenarios and Notes

Suitable for developers who want to use the dsh Web UI in a desktop window and need a tray entry and title bar.

Notes:

  • The plugin runs with the permissions of the current dsh process; you should check the source code and license before installing.
  • package.json declares electron as an optional peerDependency.
  • This plugin does not modify dsh source code and does not introduce Electron into the dsh dependency tree.

Links

  • GitHub: https://github.com/ahikl/dsh-desktop
  • Directory: https://www.skillhub.cn/plugins/ahikl/dsh-desktop