Developer preview: expect compatibility-breaking changes before the first stable release.

About this project

deepseek-harness-desktop packages DeepSeek Harness as a self-contained desktop application. It is maintained in this repository as an independent project and preserves the upstream Harness runtime, plugin architecture, and Web UI.

• One app, complete runtime — Tauri bundles the production dsh deployment and an official Node.js 24 executable.
• The full Harness experience — workspaces, sessions, settings, tools, skills, subagents, and plugin composition stay in the existing Web UI.
• Local by design — the sidecar listens only on 127.0.0.1 with an OS-assigned port.
• Supervised lifecycle — Rust starts the sidecar, waits for its readiness signal, and terminates it when the app exits.
• Small trusted desktop layer — the loopback UI receives no Tauri shell capability; process control stays in Rust.
• Cross-platform build path — bundled Node targets are defined for Apple Silicon and Intel macOS, x64 and ARM64 Linux, and x64 and ARM64 Windows.

Desktop preview

General settings	Model providers

Download

The developer-preview DMG supports Apple Silicon Macs (arm64). This build uses ad-hoc code signing and is not notarized by Apple; if macOS blocks the first launch, Control-click DeepSeek Harness, choose Open, and confirm the prompt.

• Download DeepSeek Harness Desktop v0.1.0-rc.5 (DMG, 100 MB)
• Release notes and SHA-256 checksum

Quick start

Build from source

Building from source requires the repository's Node.js and pnpm versions, Rust, and the Tauri 2 platform prerequisites.

git clone https://github.com/fendouai/deepseek-harness-desktop.git
cd deepseek-harness-desktop
pnpm install
pnpm --filter dsh-desktop build

The macOS build, which is the currently verified desktop target, is written to:

apps/desktop/src-tauri/target/release/bundle/macos/DeepSeek Harness.app

Run the desktop application in development mode with live process output:

pnpm --filter dsh-desktop dev

How it works

flowchart LR
  A["Tauri 2 desktop host"] -->|"starts and supervises"| B["Bundled Node.js sidecar"]
  B -->|"runs dsh web --port 0"| C["DeepSeek Harness runtime"]
  C -->|"serves on 127.0.0.1"| D["Existing Web UI in WebView"]
  D -->|"Typert RPC"| C
  A -->|"navigates after readiness"| D

The preparation step builds Harness and the Web frontend, creates an isolated production dependency deployment, verifies the pinned official Node.js archive with SHA-256, and gives the executable Tauri's target-specific sidecar filename. Desktop data lives under Tauri's application data directory and remains separate from the CLI's home.

The detailed runtime and cross-compilation contract lives in the desktop application README. The architectural decision is recorded in the desktop host Agent Note.

Upstream foundation

DeepSeek Harness is powered by Cordis, whose composition model is described in A Programming Paradigm for Spatiotemporal Composability. Plugins provide the model, tools, filesystem, shell, sessions, workflows, permissions, UI modules, and other capabilities; applications assemble only what they need.

The desktop host is intentionally small: product behavior continues to come from upstream-compatible Harness plugins and the existing Web UI. Start with the architecture documentation to understand the runtime, or follow the development guide to work on this repository.

Project links

• Repository
• Issues
• Upstream DeepSeek Harness

Contributing

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request. Agents working in this repository must also follow AGENTS.md.

License

DeepSeek Harness Desktop is available under the MIT License. Third-party dependencies and their licenses are listed in THIRD_PARTY_NOTICES.md.