Install DeepSeek Harness

Windows

Install Node.js 24.9.0 or newer, then in PowerShell run npm install -g @deepseek-ai/dsh.

npm writes dsh.cmd and dsh.ps1 next to node.exe in the global prefix. If dsh is not found afterwards, that prefix is missing from PATH — run npm prefix -g to see where it went.

Start with dsh web. Pass --no-open on a machine where you do not want a browser window to appear, and --port 8080 to pin the port.

node --version
npm install -g @deepseek-ai/dsh
dsh --version
dsh web --port 8080

macOS

Same package. If npm installs into a root-owned prefix you will get EACCES; either fix the prefix ownership or install Node through a version manager so the global prefix belongs to your user.

After install, dsh web boots the web profile and opens the browser; dsh web --no-open prints the URL instead.

node --version
npm install -g @deepseek-ai/dsh
dsh --version
dsh web

Linux

Install Node.js 24.9.0 or newer from your distribution or from nodejs.org, then install the package globally.

On a headless server, use dsh web --host 127.0.0.1 --port 8080 --no-open and reach it through a tunnel or a reverse proxy. --host takes one concrete local address; wildcard addresses are rejected.

node --version
npm install -g @deepseek-ai/dsh
dsh --version
dsh web --host 127.0.0.1 --port 8080 --no-open

If the first boot complains about a plugin

Plugins declare a compatible dsh range. When the installed dsh is outside it, the CLI skips that plugin and prints the requirement, the way you would see Plugin dsh-client-ui-aqua@1.3.1 is incompatible with dsh 0.2.1-rc.2.

Two fixes: install a plugin version that matches your dsh, or grant an exact-version exemption with dsh plugin allow-version, which accepts the risk for that one pair.