Skip to content
  • Home
  • Plugin manual
  • dsh-launcher

LvienOeria/dsh-launcher

30Last commit Aug 14, 2026

dsh-launcher DSH plugin

This plugin generates a `dsh-go` command that automatically starts the DeepSeek Harness Web UI and opens it in the default browser. It is zero-dependency, approximately 9KB in size, and only touches the terminal side — no desktop icons or bundled applications.

terminaldeveloper-tools

How to install the dsh-launcher DSH plugin

dsh plugin --profile web add dsh-launcher

Copying does not run this command. Review the repository and version before installing the dsh-launcher DSH plugin.

dsh-launcher DSH plugin data source

dsh-launcher DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-launcher DSH plugin can do

  • Generates a startup script (`~/.dsh-launcher/dsh-start.command`) and a terminal command (`~/.local/bin/dsh-go`) upon bundle apply.
  • Idempotent operation: does not rewrite files if configuration has not changed (state hash stored in `~/.dsh-launcher/state.json`).
  • Automatically adds the bin directory to the shell PATH via `ensurePath: true` config.
  • Supports customization of command name, Web UI URL, source directory, custom start command, and auto-open browser.
  • Security: every generated file contains a managed marker; existing files without the marker are backed up before replacement.
  • Invalid configurations (type errors, non-http(s) URL, newlines in startCommand) fail loudly with clear error messages.

Where the dsh-launcher DSH plugin fits

  • Quickly launch Harness Web UI and open the browser with a single terminal command.
  • Developers who frequently start Harness during development can use `dsh-go` for speed.
  • Customize the launch command, URL, or source directory to match different environments or proxy setups.
  • Use as a terminal complement to the desktop launcher (dsh-desktop-launcher) for headless or remote workflows.
  • Ensure the Harness is always started with the same configuration by using the plugin's idempotent setup.

Who the dsh-launcher DSH plugin is for

  • Developers using DeepSeek Harness who prefer terminal-based workflows.
  • Users who want a one-word command to start the Harness Web UI and automatically open the browser.
  • Users who need to customize the launch behavior (e.g., different port, source directory, or custom command).

dsh-launcher DSH plugin limitations

  • Does not support Windows (only prints a warning and does not install any files).
  • Requires `dsh` CLI and pnpm ≥ 9 to be installed first.
  • The default terminal command name is `dsh-go` to avoid conflicting with the `dsh` CLI command.
  • The plugin must be installed via `dsh plugin add`; it cannot be used standalone.
  • The startup script relies on the `dsh` CLI or `pnpm dsh`; if both are missing, it falls back with a warning.

dsh-launcher DSH plugin: from the repository README

Quoted from the LvienOeria/dsh-launcher README, the upstream source of the dsh-launcher DSH plugin. Copyright remains with the original authors.

一个轻量的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件：安装一个**终端命令，一个字启动 harness** —— 输入 `dsh-go`，自动启动 Web UI 并打开浏览器。Everything is a plugin，这个插件本身就是一个 bundle。 **轻量：** 零依赖，包体积约 9 KB。只碰终端侧 —— 不产生任何桌面图标、不捆绑应用。桌面双击版是独立的 [dsh-desktop-launcher](https://github.com/LvienOeria/dsh-desktop-launcher) 包，想要什么装什么，绝不捆绑。 ## 它能做什么 以 bundle 方式加载后，插件的 `apply` 会在每次 harness 启动时**收敛**以下产物（幂等：配置没变就是快速空操作）： | 产物 | 位置 | 说明 | |---|---|---| | 启动脚本 | `~/.dsh-launcher/dsh-start.command` | 启动 dsh → 轮询 Web UI 地址 → 就绪后自动打开浏览器 | | 终端命令 | `~/.local/bin/dsh-go` | 终端里输入 `dsh-go` 就是这个效果 | ## 安装 前置条件：`dsh` CLI + **pnpm ≥ 9**（harness 固定 pnpm 11 —— 版本旧的话执行 `corepack enable`）。 从 npm 安装： ```sh dsh plugin --profile web add dsh-launcher ``` 从 GitHub 安装 —— 纯 JS、**无构建步骤**，无需任何 allowlist： ```sh dsh plugin --profile web add github:LvienOeria/dsh-launcher ``` 本地路径安装也可以（零依赖）： ```sh dsh plugin --profile web add ./dsh-launcher ``` 然后启动一次 dsh，插件会自动生成启动器： ```sh dsh --profile web # 已安装 CLI # 或 pnpm dsh web # 源码目录（自动检测） ``` 搞定。终端输入 `dsh-go` 即可启动 harness；关闭那个终端窗口即停止（Ctrl+C 也可以）。 ## 自定义 编辑 profile 的 patch 层（`~/.dsh/profiles/<profile>/cordis.patch.yml`）—— 后层覆盖前层，patch 会整体替换某行的 `config`：

Read the full READMERepository license: MIT

dsh-launcher DSH plugin questions

How do I change the terminal command name from `dsh-go` to something else?

You can customize the command name by editing the profile's patch layer at `~/.dsh/profiles/<profile>/cordis.patch.yml`. Set the `command` config under `dsh-launcher` to your desired name, e.g., `harness-start`. The plugin will regenerate the command with the new name.

Can I use this plugin on Windows?

No, Windows is not supported. The plugin will print a warning and skip file installation. If you need a desktop launcher on Windows, consider using the separate `dsh-desktop-launcher` package, but note that it is also not explicitly mentioned as Windows-compatible.

What should I do if the plugin fails to install or apply?

First, ensure you have `dsh` CLI and pnpm ≥ 9 installed. If installation fails, check the error message — invalid configurations will be reported clearly. You can also try installing from a local path or GitHub directly. If the issue persists, check the state file at `~/.dsh-launcher/state.json` and remove it to force a clean regeneration.

How do I uninstall the plugin completely?

Run `dsh plugin --profile web remove dsh-launcher`, then manually delete the generated files: `rm -rf ~/.dsh-launcher ~/.local/bin/dsh-go`. Note: the command `dsh` in the README's uninstall section is likely a typo; it should be `dsh-go`.

Does this plugin work with custom Web UI ports or behind a proxy?

Yes, you can customize the Web UI URL via the `url` config in the profile patch. For example, set `url: http://127.0.0.1:8080`. The plugin will poll that URL and open the browser once ready. It also supports custom start commands if you need to set up a proxy or environment variables.