zhengjy01/dsh-start

English | 中文

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

Command	What it does
dsh-start	Start in the foreground; Ctrl+C stops the server
dsh-start -d	Start in the background (window can close); log at ~/.dsh/web.log
dsh-start stop	Stop the running server (found via the port)
dsh-start status	Show whether the server is running and its URL
dsh-start --build-app	Build/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 © zhengjy01