DeepSeek Harness (dsh) — commands & flags

Install with npm install -g @deepseek-ai/dsh (requires Node.js ^22.19.0 or >=24.0.0 per the official package.json), then run dsh web. For release channels, zero-install npx usage, and troubleshooting, see the Install DeepSeek Harness (dsh) guide.

Checked on 15 Nov 2026 against deepseek-harness on GitHub.

DeepSeek Harness is the open-source agent harness. The published npm package is @deepseek-ai/dsh (not @deepseek-ai/harness). Profiles, subcommands, and flags below come from the official apps/cli README. Agent IDE setup: Model name migration guide. Claude Code setup. Independent resource, not affiliated with DeepSeek.

Install @deepseek-ai/dsh

DeepSeek Harness is the open-source agent harness. The published npm package is @deepseek-ai/dsh, not @deepseek-ai/harness. The zero-install command in the official quickstart is npx @deepseek-ai/dsh web. It requires Node.js ^22.19.0 or >=24.0.0. Source: https://github.com/deepseek-ai/deepseek-harness

Product name on npm: DeepSeek Harness (dsh)

@deepseek-ai/dsh
dsh — documented commands only
$npx @deepseek-ai/dsh web
Examples:
$npx @deepseek-ai/dsh web
Documented command from https://github.com/deepseek-ai/deepseek-harness
Starts the Web UI at http://127.0.0.1:3080 by default.
This page does not simulate agent transcripts.

dsh commands

From the @deepseek-ai/dsh npm page and deepseek-harness GitHub README
dsh webExecution
npx @deepseek-ai/dsh web

Starts the DeepSeek Harness Web UI. Official docs say it listens at http://127.0.0.1:3080 by default. Pass --no-open to skip opening a browser.

Supported Flags
--no-open— Run the web server without opening a browser (documented on the GitHub README).
--profile <name>— Boot a named profile under $DSH_HOME/profiles/.
dsh headlessExecution
dsh --profile headless "job"

Runs one fresh persisted session, prints the final answer, and exits. Documented on the @deepseek-ai/dsh npm page.

Supported Flags
--profile headless— Select the headless profile. dsh web is the alias of --profile web.
dsh pluginTooling
dsh plugin --profile <name>

Manages a profile's plugins by forwarding to pnpm in the profile directory. Documented on the npm package page.

Supported Flags
--profile <name>— Profile whose plugins are managed.
source checkoutTooling
git clone https://github.com/deepseek-ai/deepseek-harness.git

Build from source when you need the repo's current interfaces. The quickstart says npm latest can lag master.

Steps
  1. git clone https://github.com/deepseek-ai/deepseek-harness.git
  2. cd deepseek-harness
  3. pnpm install
  4. pnpm run build
  5. pnpm dsh web