Introduction

DSH’s philosophy is that “everything is a plugin.” For agent developers, a common approach to launching the harness is to run the CLI or source commands first. If you need to launch it from the terminal with a single click and automatically open a browser, you can install dsh-launcher. The following introduces its positioning, installation methods, configuration options, and notes.

What is it

dsh-launcher is a lightweight plugin for DSH (DeepSeek Harness): it installs a terminal command where typing dsh-go will launch the harness and automatically open a browser.

It has zero dependencies with a package size of approximately 9 KB. The repository path is LvienOeria/dsh-launcher and the license is MIT. A desktop double-click version is available in the standalone package dsh-desktop-launcher.

Core Features

Generate Terminal Command & Start Script

The plugin is loaded as a bundle. The plugin apply converges and generates artifacts every time the harness starts; it is a no-op when the configuration remains unchanged.

The generated files include:

  • Start script: ~/.dsh-launcher/dsh-start.command
  • Terminal command: ~/.local/bin/dsh-go

Installation Sources

Supports installation from npm, GitHub, or local paths.

Configurable Items

The following items can be configured via profile patch:

command
url
sourceDir
startCommand
autoOpenBrowser
ensurePath

Launch Command Parsing Order

Launch commands are parsed in the following order:

  1. startCommand
  2. sourceDir
  3. Source code directory
  4. dsh CLI on PATH
  5. Fallback dsh --profile web

Security & Failure Handling

  • For existing files, if they do not have a managed by dsh-launcher marker, they will be backed up to .bak before being replaced.
  • Invalid configurations will result in an error.
  • Installation failures are only logged and do not cause the harness to fail to start.

Installation and Enabling

Prerequisites are the dsh CLI and pnpm >= 9. The harness fixes pnpm 11; if your local version is older, you can run:

corepack enable

First confirm the prerequisites are met, then install from npm:

dsh plugin --profile web add dsh-launcher

If installing from GitHub:

dsh plugin --profile web add github:LvienOeria/dsh-launcher

If a plugin directory already exists locally:

dsh plugin --profile web add ./dsh-launcher

After installation, start the harness once; the plugin will generate the launcher based on this:

dsh --profile web
# or
pnpm dsh web

After the steps above, you can use dsh-go in your terminal.

Typical Usage

Launch in the terminal:

dsh-go

To stop, close the terminal window or press Ctrl+C.

When you need to modify the launch command, URL, path, or browser behavior, edit the profile patch file:

~/.dsh/profiles/<profile>/cordis.patch.yml

The latter layer overrides the former. Example:

- id: dsh-launcher
  config:
    command: dsh-go
    url: "<Web UI address>"
    sourceDir: "<harness source code directory>"
    startCommand: ""
    # autoOpenBrowser: true/false
    # ensurePath: true/false

Only the configurable items are listed here; actual values should be filled according to your Web UI address, source code directory, and shell configuration.

command is the terminal command name, defaulting to dsh-go, and does not occupy the dsh command name of the harness CLI.

Scenarios and Notes

Suitable for scenarios where you need to launch the DSH Web UI from the terminal with a single click and do not want a desktop application.

Notes:

  • Windows is not supported: no files will be installed, only a warning will be printed.
  • The plugin runs with the permissions of the current dsh process; it generates local files, so you should check the repository source code and the MIT license before installing.
  • The state hash is saved in ~/.dsh-launcher/state.json.

The uninstallation command provided in the documentation is as follows:

dsh plugin --profile web remove dsh-launcher
rm -rf ~/.dsh-launcher ~/.local/bin/dsh

The correspondence between rm -rf ~/.local/bin/dsh and the default command dsh-go is not further explained.

Conclusion

The role of dsh-launcher is to converge the harness launch into a dsh-go command while maintaining zero dependencies and a package size of about 9 KB.

GitHub repository: https://github.com/LvienOeria/dsh-launcher

The verified documentation does not provide a directory page URL, so this article does not list uncertain links.