Skip to content
dshdocs
$ npx @deepseek-ai/dsh web
dsh web: http://127.0.0.1:3080
Ready.

The DeepSeek Harness (dsh) Handbook

Community notes on installing DeepSeek Harness, reading its error codes, and running dsh on Windows. Every answer links back to the source it came from.
Get startedFix an error

Unofficial. This site is not affiliated with DeepSeek. It’s a community-written handbook for DeepSeek Harness (dsh), an open-source project by DeepSeek AI. The official repository and its docs/ directory are the authoritative sources.

DeepSeek Harness (dsh) is DeepSeek AI’s open-source agent harness. It’s in developer preview (0.1.0-rc.x), so releases still break things and the official docs are thin in places. This handbook covers the parts people get stuck on: the install steps, the Node.js version floor, getting the Web UI into English, and one page for each error code that keeps coming up.

What is DeepSeek Harness?

Section titled “What is DeepSeek Harness?”

DeepSeek Harness (dsh) is an open-source agent harness built by DeepSeek AI, published August 13, 2026 under the MIT license. It runs on Cordis, a plugin framework where, in the project’s own words, “everything is a plugin”, including the model adapter, the tool registry, and the agent loop itself. Running npx @deepseek-ai/dsh web starts a browser-based Web UI at http://127.0.0.1:3080; you can also build it from source with pnpm. The rest of this site deals with the rough edges of software this new.

Start here

Section titled “Start here”
Install DeepSeek HarnessCovers npx, a global install, and building from source. Also the Node.js version floor, which is where most first installs fail.Switch the dsh Web UI to EnglishA fresh install can come up in Chinese, because dsh follows your browser’s language list. One setting in the Web UI changes it.DeepSeek Harness error fixesOne page per failure, each sourced: 400 INVALID_REQUEST on tool calls, a plugin remove that leaves a broken profile, sessions that refuse to resume.DeepSeek Harness (dsh) on WindowsIt runs, with caveats: sandbox crashes after a Temp cleanup, PowerShell quoting, and no official desktop app.Migrate from Claude Code to dshdsh reads Claude Code’s hooks.json, but two differences in that compatibility layer make security hooks fail silently.Profiles, bundles & patchesHow dsh’s Cordis-based config model fits together, in plain English, with a real-syntax example.

Frequently asked questions

Section titled “Frequently asked questions”
Is it DeepSeek Harness or DeepSeek Hardness?
Harness, spelled with an r. "DeepSeek Hardness", "herness" and "harnes" are all misspellings of the same project, and nothing ships under those names. The CLI command is dsh, short for "DeepSeek Harness."
What is DeepSeek Harness (dsh)?
DeepSeek Harness (dsh) is an open-source agent harness from DeepSeek AI. It runs on the Cordis plugin framework, and npx @deepseek-ai/dsh web starts a local Web UI at http://127.0.0.1:3080. The project is still in developer preview.
Is dshdocs an official DeepSeek site?
No. dshdocs is an unofficial handbook maintained by the community. The authoritative docs live in the official repository at github.com/deepseek-ai/deepseek-harness.
Is DeepSeek Harness free and open source?
Yes, MIT-licensed. The source is on GitHub at deepseek-ai/deepseek-harness, and releases go out as the npm package @deepseek-ai/dsh.