Before you start

DeepSeek Harness is currently in developer preview. The official repository recommends installing Node.js and launching dsh through npx, which avoids confusing the current CLI with older packages that also used the dsh name.

  • Node.js 22.19 or newer is the safest current baseline.
  • A terminal: PowerShell on Windows, Terminal on macOS, or your preferred shell on Linux.
  • Network access for npm to download @deepseek-ai/dsh.

Launch the web interface

Run the same command on Windows, macOS, or Linux. npx downloads the official package when needed and starts the default web profile.

npx @deepseek-ai/dsh web
The Web UI is served at http://127.0.0.1:3080 by default. Keep the terminal open while you use the interface.

Run from source

Contributors can clone the official repository, install its workspace dependencies with pnpm, build the packages, and then run the local CLI.

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Install a plugin

Plugins are added to a named profile. Community packages differ: some are published to npm, while early projects may be installed from GitHub or a local checkout. Use the exact command documented by the maintainer.

npx -y @deepseek-ai/dsh plugin --profile web add <package-or-git-source>

What to do next

  • Open the plugin directory and choose one capability you actually need.
  • Read the repository README and compatibility notes.
  • Restart long-running profiles after their bundle list changes.
  • Expect breaking changes while dsh remains in developer preview.