deepseekplugins

DeepSeek Harness plugin

dsh-start

One-click start/stop launcher for DSH Web on macOS — start (foreground/daemon), stop, status, duplicate-launch guard, auto browser open, plus a Dock-able DSH.app built by script.

Development & Runtime
Jump to install

Source facts

Repository
zhengjy01/dsh-start
Latest update
Aug 18, 2026
Category
Development & Runtime
GitHub stars
0

Install

Start with a prompt that asks an agent to read the source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to read the page and repository first.

Do not install anything yet. Read this DeepSeek Harness plugin and explain what it does, which files, networks, or credentials it can access, and how to install and remove it.

Plugin page: https://deepseekplugins.org/plugins/zhengjy01/dsh-start
GitHub: https://github.com/zhengjy01/dsh-start
Plugin: dsh-start
Author: zhengjy01
Install command: dsh plugin --profile web add dsh-start

Do not run the install command until I confirm.

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-start

> English | [中文](README.zh.md)

A one-click launcher for DeepSeek Harness (DSH) Web on macOS. Stop typing dsh web by hand — start, stop, and check the server from a single command, or build a Dock-able DSH.app that behaves like a normal macOS application.

Features

  • One command, four modes — dsh-start (foreground, logs visible, Ctrl+C to stop), dsh-start -d (daemon, logs to ~/.dsh/web.log), dsh-start stop, dsh-start status.
  • Duplicate-launch guard — if the server is already up (default port 3080), it just opens the browser instead of starting a second instance.
  • Auto-open browser — polls the port after launch and opens http://127.0.0.1:3080 once ready (both foreground and daemon modes).
  • Normal-app feel (DSH.app) — scripts/build-dsh-app.sh compiles a stay-open launcher app at ~/Applications/DSH.app: double-click to start, Cmd+Q (with a confirmation dialog) to stop. Re-clicking the Dock icon ensures the server is running and opens the browser.
  • Permission-safe by design — the app delegates the server process to Terminal (which has full file-access context), avoiding the macOS sandbox/TCC EPERM failures that occur when a bare app spawns dsh directly.

Install

From npm (recommended)

npm install -g dsh-start
dsh-start            # start in foreground
dsh-start status     # is it running?

From source

git clone https://github.com/zhengjy01/dsh-start.git
cd dsh-start
./bin/dsh-start      # same CLI

Build the Dock app (optional)

dsh-start --build-app        # same as scripts/build-dsh-app.sh
# or
./scripts/build-dsh-app.sh   # needs python3 + Pillow for the icon

Usage

CommandWhat it does
dsh-startStart in the foreground; Ctrl+C stops the server
dsh-start -dStart in the background (window can close); log at ~/.dsh/web.log
dsh-start stopStop the running server (found via the port)
dsh-start statusShow whether the server is running and its URL
dsh-start --build-appBuild/refresh ~/Applications/DSH.app

The port defaults to 3080 (the dsh web default); override with the DSH_PORT environment variable.

How it works

  • scripts/start-dsh.sh checks the port first. Already running → open the browser. Otherwise it launches dsh web in the foreground (or nohup'd in daemon mode) and watches for readiness.
  • scripts/DSH.applescript is a stay-open AppleScript app (osacompile -s): run/reopen ensure the server is up and open the browser; quit asks for confirmation and runs start-dsh.sh stop before exiting.
  • The build script generates the icon with Pillow, compiles the app, patches Info.plist, and registers it with LaunchServices.

Troubleshooting

  • EPERM: operation not permitted when launching from the app — this is a macOS permission-context issue: run dsh-start --build-app (v2 app delegates to Terminal), or start via dsh-start in your own terminal.
  • Sessions "missing" after a restart — session data is never deleted; it lives in ~/.dsh/sessions. If the app-spawned server crashed at boot (see ~/.dsh/web.log), start from the terminal instead and the sidebar repopulates.
  • First launch of DSH.app — macOS may ask "DSH wants to control Terminal"; click Allow (one-time).

License

[MIT](LICENSE) © zhengjy01

Back to searchOpen GitHub repository

More related plugins

View category