DeepSeek Harness Desktop

English | 中文

This repository is the desktop edition of the official DeepSeek Harness (dsh). It keeps the upstream plugin-based agent harness and adds an Electron shell (apps/desktop) that opens the same Web UI in a native window.

DeepSeek Harness 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.

Upstream source of truth: deepseek-ai/deepseek-harness.

Developer preview

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

Run

Run from source

This checkout is the desktop edition. Clone, build, then open the Electron window:

git clone https://github.com/wink-run/deepseek-harness-desktop.git
cd deepseek-harness-desktop
pnpm install
pnpm run build
pnpm run desktop

The desktop shell starts nested dsh web on loopback and opens a native window. See apps/desktop/README.md.

GitHub Releases on this repository build and attach macOS / Windows installers via Desktop Release when you push a version tag (e.g. 0.1.0) or publish a Release.

For the browser UI only:

pnpm dsh web

The Web UI is served at http://127.0.0.1:3080 by default. See Web UI guide.

Run from npm

Install Node.js, then run the official package without this checkout:

npx @deepseek-ai/dsh web

Community and support

• Upstream feedback: GitHub Discussions.
• Add the dsh-plugin topic to your plugin repository for discoverability.
• Join DeepSeek Harness Discord community.

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

For agents, follow AGENTS.md.

License

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.