DeepSeek Harness Desktop (DSH Desktop)
An open-source DeepSeek Harness desktop client for Windows and macOS.
One-click download, ready to use out of the box.
Everything is a plugin — the desktop itself is a plugin.
Community maintained and not an official DeepSeek product. 中文 · English
DSH Desktop packages the local Web UI, Host service, and plugin system from DeepSeek Harness into a native desktop application. Official Harness runs unchanged at a pinned version; Desktop provides the window, tray, terminal, updates, and work profiles through the official plugin composition.
Download and install
Current release installers support Windows x64 and Apple Silicon macOS. Ordinary users do not need to install Node.js, pnpm, or DSH separately.
| Platform | Download | Installation |
|---|---|---|
| Windows x64 | Download installer | Run the NSIS installer and follow its prompts |
| macOS Apple Silicon | Download DMG | Open the DMG and drag DSH Desktop into Applications |
Installers and SHA-256 digests are also available from GitHub Releases. The first launch creates the default desktop profile and starts the official DSH Web interface locally. See the user guide and FAQ for plugin commands, platform details, and troubleshooting.
Together with every plugin author, we want to build an open, composable, and sustainable DSH plugin ecosystem where plugins grow alongside each other. Read the DSH plugin ecosystem manifesto.
Documentation
Ordinary users can start with the user guide; the developer documentation is only needed when extending or maintaining the application.
User documentation
| Goal | Entry point |
|---|---|
| Install and use the application | User guide |
| Check platforms, prerequisites, and product boundaries | FAQ |
| Understand why the project exists | Why DSH Desktop |
| See the full documentation and README map | Documentation index |
Developer and maintainer documentation
| Goal | Entry point |
|---|---|
| Read the plugin ecosystem manifesto | Plugin ecosystem manifesto |
| Build ordinary or Desktop plugins | Plugin development |
| Join the unified plugin-contract discussion | DSH Community Fabric Draft |
| See the research behind the unified plugin framework | Framework and real-plugin research |
| Read the plugin market product and safety design | DSH Community Market |
| See what Desktop plugins can use | Desktop plugin API |
| Understand how the desktop works | Architecture |
| Read package-level build and release details | dsh-plugin-desktop/README.md |
Features
DesktopBring the official DeepSeek Harness local Web UI to a native desktop application. The app starts and manages the local Harness service, integrates the system tray and desktop window, and requires no Node.js installation or command-line setup. |
Mobile Remote Control
Connect to Desktop from iOS and Android to start tasks, monitor Agent progress, and send follow-ups from your phone. |
Plugin Marketplace
We are using DSH Community Market to design plugin discovery, details, and confirmed installation. It currently contains product and safety documentation, not a usable market page. |
Co-build the Plugin EcosystemThe DSH plugin ecosystem is built by the community. Official, desktop, and third-party plugins follow the same conventions, so they can be installed together and work together without interfering with each other. Join us — read the DSH plugin ecosystem manifesto. |
Plugin Ecosystem
Plugins are extensions that add capabilities to DSH — models, tools, interfaces, and workflows can all be plugins, combined like building blocks.
DSH Desktop does not fork or modify upstream source, and it is not a fixed, hardcoded shell. Official DeepSeek Harness runs unchanged at a pinned version; the desktop shell itself — the window, tray, terminal, updates, and work profiles — is a legitimate DSH plugin, composed into the same runtime through the official plugin mechanism. From the core agent to the desktop shell, the whole product follows the same "everything is a plugin" rule: plugins from the official ecosystem work directly, and desktop capabilities are combined, replaced, and evolve the same way.
We want the plugin ecosystem to work like a phone app store: every plugin is built against the same set of rules, so plugins can be installed together and work together without interfering with each other.
For developers
Unlike many other projects, this project itself is a DSH plugin: the desktop shell composes through the same official path as third-party plugins. Desktop plugin capabilities are now available. We provide Desktop services so plugin developers can integrate their plugins with desktop capabilities: for example, viewing and switching work profiles, or installing, updating, and removing plugins in the active profile. See the Desktop plugin API for complete usage details. See Why DSH Desktop and Plugin development for the reasoning and the third-party boundary.
Relationship to the Official Project
This project is built on deepseek-ai/deepseek-harness.
This project is an implementation built on DeepSeek Harness and the Cordis plugin model, intended to provide the foundation for the DSH desktop experience.
The official project provides the core agent capabilities, plugin system, and Web UI. This project primarily provides:
- Desktop application packaging
- Starting, stopping, and recovering the local service
- Desktop window and system tray integration
- macOS and Windows installer builds and releases
- An interface designed for desktop use
If you prefer to run Harness from the command line or contribute to its core functionality, refer to the official repository first.
Special Thanks
Special thanks to the original DeepSeek Harness repository and the DeepSeek AI team. DSH Desktop is built from a pinned upstream checkout, and its core agents, models, tools, sessions, Web UI, and plugin ecosystem come from that project.
We also thank Cordis for the plugin foundation that makes this composition possible. DSH Desktop would not exist without these open-source projects.
We are also grateful to the Koishi.js project and community for their long-standing work on plugin practices, tooling, and shared knowledge, and to everyone who contributes discussions, testing, feedback, and plugins.
Also, and you.
Development
Desktop source lives in dsh-plugin-desktop/. The outer repository uses Yarn, while the pinned deepseek-harness/ submodule keeps its own pnpm workspace. From the repository root:
git submodule update --init --recursive
corepack yarn install --immutable
corepack yarn dev
Use corepack yarn check for the headless gate. The architecture and package README describe the full build, test, and release boundaries. See CONTRIBUTING.en.md for how to contribute.
Community
Choose whichever platform you prefer to discuss usage, plugin development, and project updates.
| WeChat Group | QQ Group |
|---|---|
 |
 |
Discord: Join the DeepSeek Harness Desktop community
If you would like to join our technical team, contact us at [email protected].
Related Links
Ecosystem projects and developer tools around DeepSeek Harness.
| Project | About | Link |
|---|---|---|
| dshfind | The learning & sharing community for DeepSeek Harness (DSH). | GitHub |
| DSH 1024Store | A community plugin directory for the DeepSeek Harness (DSH) ecosystem (4,120 plugins), open-sourcing an online marketplace, a collection pipeline, and a public query API — fork it to deploy your own marketplace. | GitHub |
| ModLens | Adds OCR, layout, and semantic vision capabilities to DeepSeek Harness and text-only coding agents. | GitHub · Website |
| DeepSeek Harness Orange Book | Community field manual for DeepSeek Harness. | GitHub |
| dsh-web-ui | DeepSeek Harness Web UI plugins and themes. | GitHub · Gallery |
| dsh-TUI | Full-screen interactive terminal interface for DeepSeek Harness. | GitHub |
| dsh-tianshu-tui | Minimalist interactive terminal UI plugin for the DSH web client with a self-developed ANSI rendering core for silky-smooth output; adds TDD, evidence gates, and vision/image module workflows on top of the official UI. | GitHub |
| Agents-Anywhere | Remote-control your desktop coding agent from your phone. | GitHub |
| DSH-better-sidebar | Sidebar workbench for DeepSeek Harness with files, terminal, Git, and subagents. | GitHub |
| Awesome DeepSeek Harness | Curated list of DeepSeek Harness plugins, tools, and infrastructure. | GitHub · Website |
| MkSaaS · TanStarter (Sponsor) | Commercial SaaS starter templates for indie developers. MkSaaS is built on Next.js; TanStarter on TanStack Start and Cloudflare, with AI, auth, payments, and admin baked in. | MkSaaS · TanStarter |
To list your project, join the WeChat group and message @王博升Benson, or contact [email protected], or open an issue.
License
This project is licensed under the MIT License.
This is a community desktop edition built on DeepSeek Harness. It is not an official DeepSeek product.
DeepSeek is a trademark of DeepSeek AI. DSH Desktop is an independent community project, not affiliated with or endorsed by DeepSeek.