DeepSeek Harness

August 14, 2026 · View on GitHub

English | 中文

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.

It uses an architecture where everything is a plugin, and is powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

Developer preview

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Run

Desktop app

This fork adds a desktop build of the same Web UI. It carries its own runtime, so nothing has to be installed first.

⬇ Download for Windows x64 · ⬇ Download for macOS Apple Silicon

Artifact	Use
`DeepSeekHarness-Setup-x64.exe`	Windows installer: choose a directory, get Start-menu and desktop shortcuts, uninstall from Settings.
`DeepSeekHarness-portable-x64.zip`	Windows portable: unpack anywhere and run `DeepSeek Harness.exe`.
`DeepSeekHarness-mac-arm64.dmg`	macOS Apple Silicon: open the disk image and drag the app to Applications.
`DeepSeekHarness-mac-arm64.zip`	macOS Apple Silicon, no disk image: unpack and run `DeepSeek Harness.app`.

Those links always serve the newest build; Releases lists what changed in each.

The build is unsigned. Windows SmartScreen interrupts the first launch: choose More info → Run anyway. On macOS, Gatekeeper blocks an unsigned download until you clear the quarantine once:

xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"

or open it once from System Settings → Privacy & Security → Open Anyway.

Open the Models page on first use and paste a DeepSeek API key. It is stored in ~/.dsh/.credentials.yaml (%USERPROFILE%\.dsh\.credentials.yaml on Windows), the same place the dsh command line reads, so both surfaces share one key. Sessions open in a DeepSeek Harness folder under Documents unless DSH_DESKTOP_WORKSPACE names another directory.

The desktop package has no terminal tool: its persistent-terminal backend is a compiled module the package does not carry. Ordinary shell commands, file editing, skills, and web search all work. apps/desktop documents the shell and how to build the package yourself.

Run from `npm`

Install Node.js, then run:

npx @deepseek-ai/dsh web

The command starts the Web UI, served at http://127.0.0.1:3080 by default. See Web UI guide.

Run from source

To run from a repository checkout:

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

Community and support

Feel free to submit feedback or bug reports through GitHub Discussions.
Add the dsh-plugin topic to your plugin repository for discoverability.
Join DeepSeek Harness Discord community.