DeepDeck

A native-feeling desktop client for DeepSeek Harness.

DeepDeck is a native-feeling desktop client built on DeepSeek Harness. The upstream project is pinned as a shallow Git submodule at vendor/deepseek-harness; this repository owns the desktop lifecycle, plugin-composed interface, branding, packaging, and automatic-update layer. The Community Market from anywhere-labs/deepseek-harness-desktop is pinned under plugins/community-market, while dsh-codex-connect remains a separate pinned checkout. Both are preloaded as ordinary Cordis bundles.

DeepDeck reuses the official web profile and its complete plugin-composed UI. The desktop host starts the Harness process on an OS-assigned loopback port, waits for it to become ready, then opens the local UI in the application window. Closing the app shuts the Harness process down cleanly.

Trusted local plugin source can be compiled from Settings → Plugins → Bun Builder. DeepDeck bundles Bun for this flow, creates a private source snapshot, requires an explicit build-plan confirmation, and emits a checksummed .tgz without running dependency lifecycle scripts. When the selected source is the exact package mounted by the current Cordis profile, the same plan can instead build in place and hot-replace its Host and Client entries without restarting the desktop App. The selected package's own build script still runs with the user's permissions.

First run

Prerequisites: Node.js ^22.19.0 or >=24.0.0, Corepack, and Git.

git submodule update --init --depth 1
pnpm install
pnpm bootstrap
pnpm start

pnpm bootstrap installs and builds the pinned Harness, Community Market, and Codex Connect sources, then builds the desktop app. Later starts only need pnpm start unless a pinned source revision changes.

The desktop uses the standard Harness home ($DSH_HOME, or ~/.dsh when unset), so profiles, model settings, credentials, patches, and installed plugins remain compatible with the upstream CLI. Set DSH_HOME before launch if an isolated desktop profile is desired.

Branding

User-facing branding lives outside the upstream submodule in branding/brand.json. Replace the referenced wordmark, mark, favicon, and app icon files to rebrand the desktop without editing vendor/deepseek-harness. Set DESKTOP_BRAND_PATH to load a different manifest at launch.

Useful commands

pnpm start             # build and launch the desktop client
pnpm start:packaged    # rebuild and launch the packaged desktop client
pnpm check             # type-check desktop main, preload, and renderer code
pnpm test              # run focused desktop tests
pnpm package:local     # build and verify an unsigned local macOS package
pnpm package:mac       # build signed production macOS packages
pnpm harness:build     # rebuild the pinned Harness checkout
pnpm market:build      # rebuild the pinned Community Market bundle

See docs/architecture.md for the dependency boundary and the plugin integration direction.

Desktop updates

Packaged builds check for an update shortly after launch. When a release is available, the desktop sidebar shows an update indicator; the user starts the download explicitly and sees native updater progress. After the download completes, the desktop safely stops its Harness process, installs the update, and restarts automatically. Development launches do not contact an update service.

electron-updater reads the release provider generated into app-update.yml by the packaging pipeline. DEEPSEEK_DESKTOP_UPDATE_URL can override that provider with a generic HTTP(S) feed for controlled builds and update testing. Production updates are published to https://deepdeck-updates.getmegaportal.com. The feed contains platform metadata, signed artifacts, and blockmaps; macOS releases include the ZIP update target alongside the DMG.

See docs/release.md for the signed release process and rollback model.

License

DeepDeck is available under the MIT License. The pinned DeepSeek Harness submodule, Community Market import, and other third-party dependencies retain their own licenses.