deepseek-harness-desktop

Features

• 🪶 Native desktop — Tauri 2 + React 19 + HeroUI 3, embedding the local Harness UI.
• 📱 Remote connection — Scan a QR code in the Android / iOS app to connect to your computer's DSH over LAN or a Cloudflare public tunnel.
• 🔄 Runtime management — Install dependencies, select core versions, and access desktop/core updates.
• 🧩 Plugin management — 12 built-in plugins, plus local-directory installs, built-in disabling, community plugin installation, upgrades, removal, and error details.
• 🗂️ Profile configuration — Separate plugin/settings configurations, with one-click profile data migration, backup, and cloning.
• 💽 Data directory — Pick where data lives during installation (Windows); migrate or roll it back later in Settings on Windows, macOS, and Linux.
• ⌨️ CLI integration — Managed dsh / pnpm commands via shims, not a global npm core installation.
• 🐾 Desktop pets — Pets / Codex resources, pack imports, and conversation activity; preset media comes from remote hosts.
• 🎨 Personalization — 8 palettes, local UI scaling, terminal mode, adjustable opacity, and optional frosted blur.

Built-in plugins

First-party plugins distributed with desktop resources:

• DSH Tauri — Core plugin: desktop-to-Harness communication, version adapters, and plugin dependency management
• DSH Tauri UI — Desktop settings UI, native core components, themes, and palettes
• DSH Tauri Mobile UI — Touch layouts and mobile preferences
• DSH Tauri Worktree — Session-level Git worktrees and checkout
• DSH Tauri Extension — Official plugin manager, plugin market, Skills, and MCP
• DSH Tauri Scheduler — Scheduled tasks and run history
• DSH Tauri Archive — Chat archiving and restoration
• DSH Tauri Pet — Desktop pet and activity state settings
• DSH Tauri Rightclick Menu — Session, workspace, and text context menus
• DSH Tauri Model — Model selection, parameters, and automatic configuration
• DSH Tauri Remote — Remote Harness connections and sync over SSH, plus sharing the local Harness over LAN or a public tunnel
• DSH Tauri Notification — Conversation notifications and actions

Optional presets

Setup offers the following community plugins for installation on demand.

• DSH Better Sidebar — Per-session editor sidebar
• Billion Context — Context compression and history restoration
• DSH Office Kit — Office documents, PDF, presentations and spreadsheets
• DSH Market — Community plugin market
• DSH Rewind — Conversation rewind and workspace backups
• DSH IM — IM channels and bot management
• DSH OPS — Low-level operations tools to reduce token usage and task execution time

Request new or updated presets via Issues. Available versions follow the manifest's core compatibility rules.

Quick Start

Download the installer for your platform and architecture from Releases:

macOS also supports Homebrew installation:

brew install dsh-tauri/desktop/deepseek-harness

On Fedora 43+ (x64 / ARM64) you can install from the Copr repository. Upgrades come through dnf upgrade and in-app updates are disabled. For prereleases install dsh-tauri-beta instead (it conflicts with dsh-tauri; switch with sudo dnf swap dsh-tauri dsh-tauri-beta):

sudo dnf copr enable fairyband/dsh-tauri
sudo dnf install dsh-tauri        # stable

• Standard installers need network on first launch to download missing runtime/core components. Git features require an available Git.
• Names with a Bundle suffix are offline installers (_Bundle_*.exe, _Bundle_*.deb, and two _Bundle_*.dmg).
• Local execution is not fully offline: model services, plugin installation, updates, and preset pet media can still use network.
• For Linux display, Wayland, AppImage, and permission workarounds, see the installation and troubleshooting docs.

Desktop proxy

• Set an HTTP, HTTPS, SOCKS5, or SOCKS5H proxy in Configuration → Application → Proxy URL.
• Applies only to desktop runtime/core downloads, update checks, and plugin metadata—not model requests or plugin subprocess networking.
• Leave empty to inherit system/environment settings. Saved changes apply to new requests; retry failed downloads afterward.
• SOCKS5H resolves destination names through the proxy; loopback connections stay direct.

Mobile support

DSH Mobile accesses Harness on your computer over LAN or a public tunnel; it does not run a core on the phone.

• Android: download an APK from Releases.
• iOS: install the beta through the TestFlight invitation, subject to approval and available slots. Unsigned IPAs in Releases require your own signing.

Enable sharing from Share in the desktop's top bar, then scan the QR code to pair. Keep the computer, Harness, and any tunnel online. Access is not read-only; keep QR and access codes private. See the mobile remote access guide.

The app is maintained only until an official mobile service launches. Development details are in the mobile specification.

Runtime

Windows startup failures show a native dialog with the underlying error. For STARTUP_LOW_INTEGRITY:

• The process runs below Medium integrity and cannot write normal user data; updates can inherit a folder's Low label.
• Inspect the folder and executable with icacls. Restore a trusted installation to Medium, or reinstall into a normal folder.
• Running as administrator does not remove the Low-label restriction. Keep sessions and DSH_HOME unchanged.

Older cores are no longer supported. Earlier compatibility records describe history, not the current support range.

• Core and preset selection follow the resource manifest and declared plugin version ranges, not a promise of compatibility with arbitrary latest upstream releases.
• CLI integration is enabled by default in release: Windows / macOS / Linux update PATH automatically. Reopen your terminal; other shells may still need manual setup.

Community

Development

See the English development guide or Chinese development guide. Feature details are in the online docs.

Notes

[!WARNING] Developer preview — upstream dsh evolves quickly and may introduce breaking changes; check compatibility before upgrading.

[!NOTE] Security — dsh can execute code locally. For learning / research / testing only; run it in a trusted, isolated environment.

Community Picks

• dsh-tauri-notify-webhook - Forward notifications to webhook, email (SMTP) or pushplus when a task stops abnormally or finishes by @iuuuuuuuu
• dsh-pdf-reader - Page-by-page PDF reading, local OCR, citations, search and visual cropping by @SkanderBog
• dsh-context-manager - Review context before applying, and choose per full-history group to keep, summarize or omit earlier content by @SkanderBog
• @ryuu-64/dsh-find-all - Ctrl+F in the current conversation to find saved history by @Ryuu-64

Related

• deepseek-harness — upstream dsh agent platform
• deepseek-harness-pkg — prebuilt Harness distributions and download source
• dsh-pet · dsh-pet-mov · dsh-pet-component — pet assets and renderer
• dsh-plugin-codex-pets · BongoCat · dsh-dafeiyu · codex-to-dsh-pet — pet reference projects

Contributors

License

MIT with a Non-Commercial Condition © deepseek-harness-desktop contributors