dsh-launcher

Every time you want to use DeepSeek Harness from source, the ritual is the same: open a terminal tab, type the command, dig the tokenized URL out of the logs, go back to the tab after a pull to kill and restart, and remember to stop the server when you are done. The terminal was never the point of the tool — it was just the tollbooth in front of the browser tab where the real work happens. dsh-launcher, paired with the macOS menu bar app in the same repository, collapses start, open-in-browser, restart, and stop into single clicks. The status icon reflects server state in real time, there is no Dock icon, and nothing sits in the way. Command, port, project directory, and target browser are all configurable, so it works just as well for vite, python -m http.server, or any other long-running local server.

The companion DSH host plugin runs inside the harness itself. Once the server begins listening it writes a small runtime.json containing the port, PID, and authenticated URL; when the server stops the file is removed. This means that even when you start the server from a terminal rather than from the menu bar app, the app can still open a browser tab with the correct launch token instead of hitting a 401. The plugin is optional — the app falls back to parsing its own startup log — but with it in place, managing servers across different launch sources becomes seamless.

Built for macOS developers who run DeepSeek Harness from source day to day, or anyone tired of context-switching between a browser tab and a terminal window to keep a local server alive. A single Swift file, zero dependencies, MIT licensed: compile, sign, done.