DSH Desktop

English | 中文

deepseek-harness-desktop packages DeepSeek Harness as the native Electron application DSH Desktop. The desktop shell is the product-specific layer; the bundled dsh runtime keeps its plugin system, sessions, tools, PTYs, persistence, CLI identity, and documentation vocabulary.

_{Native window capture from the installed macOS bundle using an isolated temporary profile and preset sessions, framed against a neutral backing.}

Native macOS experience

	Compact native frame Content fills the window while controls share the traffic-light region, with native dragging and full-screen behavior.
	Glass that remembers Light, Dark, and System appearances follow macOS; the glass preference persists, with an opaque Reduce Transparency fallback.
	Zero-width focus mode Collapse the sidebar completely to reclaim the conversation width, then restore the last usable sidebar size.

Desktop shell, full harness

Bundled runtime The installed app starts its own application-scoped DSH child. A system Node.js or separately installed DSH CLI is not required.	Private desktop carrier The sandboxed renderer crosses a context-isolated preload bridge and validated IPC. The desktop profile opens no browser-facing HTTP listener.
Native macOS shell Electron main owns directory selection, path opening, compact window chrome and native dragging, recovery, and process-tree cleanup; the sidebar uses the saved glass preference.	Shared DSH state DSH Desktop and the CLI use the same ~/.dsh home, so sessions, profiles, and configuration remain available to both.

How it works

The React client retains the transport-neutral Connection surface used by the Web product. Electron main owns the native window and supervises one dedicated DSH child; that child owns Cordis, sessions, plugins, model execution, PTYs, persistence, and subprocesses.

The desktop application reference owns the complete carrier, lifecycle, packaging, native-action, recovery, and installed-app acceptance contracts.

Install

Homebrew (recommended)

brew tap mel0nyrame/dsh
brew install --cask dsh-desktop

The cask selects the arm64 or x64 build for the current Mac and removes the quarantine attribute after installation. Stable releases update the cask automatically; prereleases remain available from GitHub only.

GitHub Releases

Download the DMG for your Mac (arm64 for Apple silicon or x64 for Intel) from GitHub Releases, verify it against the adjacent .sha256 file, and drag DSH Desktop to Applications.

Release DMGs are ad-hoc signed and not notarized. A direct DMG download may therefore require the one-time macOS right-click → Open flow. The Homebrew cask performs the corresponding quarantine handling during installation.

Run from source

From this repository checkout:

pnpm install
pnpm run build
pnpm run dev:desktop

Build macOS artifacts

pnpm --filter @deepseek-ai/dsh-desktop run package

The package command writes the host-architecture .app and .dmg under apps/desktop/dist/.

Project boundaries

• DSH Desktop application reference — Electron architecture, security, lifecycle, packaging, acceptance, and limitations.
• DeepSeek Harness architecture — the bundled plugin runtime and its extension model.
• DeepSeek Harness user documentation — core DSH concepts and supported workflows.
• Archived upstream README: English · 中文 — the original project overview and onboarding material retained when the desktop homepage replaced the root entry.
• Upstream repository — the original DeepSeek Harness project this desktop repository is based on.

Status and distribution

• The repository and application are under active development; compatibility-breaking changes remain possible.
• Product releases provide separate arm64 and x64 macOS DMGs with SHA-256 checksum files.
• Developer ID signing and notarization are not configured; direct downloads may need the one-time right-click → Open flow described above. Read the desktop limitations before redistributing artifacts.

Development

Core contributor workflows remain in CONTRIBUTING.md, the development guide, and AGENTS.md. Changes to the bundled harness continue to follow those upstream-derived contracts; desktop-specific implementation lives under apps/desktop and its supporting desktop plugins.

License

MIT

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