deepseek-ai/deepseek-harness

What it is

DeepSeek Harness (dsh) is an open-source agent harness from DeepSeek AI. Its design is built around an everything-is-a-plugin architecture and runs on Cordis, a composition framework described in the paper A Programming Paradigm for Spatiotemporal Composability. The project targets developers who want to run and extend AI agents locally, and it publishes separate user documentation for the Web UI guide and the architecture docs.

The project is in developer preview and states plainly that compatibility-breaking changes will occur, so treat it as an early, moving target rather than a stable platform.

Quick start

Running from npm requires Node.js installed. Then:

npx @deepseek-ai/dsh web

This launches the Web UI at http://127.0.0.1:3080 and opens it in your default browser. In an SSH session only the host URL is printed, because the SSH client or editor owns the forwarded address; pass --no-open to start the server without opening a browser.

To run from source instead:

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

pnpm run build produces the artifacts that pnpm dsh web consumes without rebuilding. For active front-end work, pnpm run dev:web builds, serves and rebuilds client bundles on source edits, and make help lists the corresponding Make targets for Web and Desktop. Read the safety notice before running the project.

Constraints

• Node.js and pnpm are the documented runtimes; the source workflow assumes pnpm for install and build.
• Developer preview: the README explicitly warns of breaking changes.
• Safety review required: the project directs users to its safety notice before execution, which is worth reading given that an agent harness can invoke tools and act on your behalf.
• License: MIT; third-party dependencies and their licenses are listed in the third-party notices.

Extension and community

Plugins are the extension path: add the dsh-plugin topic to your plugin repository for discoverability, file feedback and bugs through GitHub Discussions, and join the Discord community for support. Contributors should start with the development and architecture guides; the project also ships an AGENTS.md for agents working in the repository.

HotRepo's take

There is no HotRepo ranking or snapshot history for this repository yet; the only station-side records are two Hacker News threads from August 2026, one of which drew a single comment arguing that replacing code and tool calls with configuration and skills sharply increases token consumption while removing the classic compile-and-deploy cycle. That is one reader's impression, not a measured result, but it points at the real trade-off of the everything-is-a-plugin model: flexibility and live modification come at a cost in token budget and, given the developer-preview label, in API stability.