Overview

`dsh` is the agent harness DeepSeek AI develops itself. `npx @deepseek-ai/dsh web` brings up a Web UI on `http://127.0.0.1:3080`, and the architecture behind it is one where everything is a plugin, powered by the Cordis runtime, so it suits people who intend to extend a harness rather than only operate one. The caveat comes from the project itself: it is labelled a developer preview and warns in capitals that there will be compatibility-breaking changes, so plugins written today should budget for rework. It is also a poor fit if you want a documented scripted or embedded entry point right now, since the README covers only the `web` command and a source checkout, and links out to a development guide and architecture documentation without saying what either contains.

What can you do with deepseek-harness?

Get a Web UI running from one command — With Node.js installed, npx @deepseek-ai/dsh web starts the harness and serves its Web UI at http://127.0.0.1:3080 by default.
Build on the plugin architecture — The harness is powered by the Cordis runtime under an everything-is-a-plugin architecture; the README's Development section points at a development guide (docs/development.md) and architecture documentation (docs/architecture.md).
Make your plugin discoverable — Adding the dsh-plugin GitHub topic to a plugin repository is the route the README gives for discoverability, with feedback and bug reports going through GitHub Discussions or the project's Discord.
Run and modify the harness from source — Clone the repo, then pnpm install, pnpm run build and pnpm dsh web to launch your own checkout instead of the published package.
Hand the repo to a coding agent — The README directs agents working in this codebase to follow AGENTS.md at the repo root.

Documentation

Reproduced from the deepseek-ai/deepseek-harness README, published under MIT. Read the original ↗

DeepSeek Harness

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

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