DSHCode

English | 中文

DSHCode is a free, open-source desktop AI agent app for macOS and Windows. It wraps the official open-source DeepSeek Harness Web UI and plugin runtime in a single installable Electron application — no Node.js, no terminal, no CLI required.

Features

DSHCode inherits the full DeepSeek Harness capability set and adds a one-click desktop experience.

Agent core — Plugin-based harness with bash, filesystem, web search/fetch, terminal, LSP, and subprocess tools; sandboxing and per-action approval prompts.

Interactive UI — GenUI cards rendered inline: charts, tables, quizzes, 3D scenes, diagrams, forms, and progress views.

Skills — Installable skill catalog that gives the agent specialized workflows — research, documentation writing, visual tools, and more.

Orchestration — Subagents for parallel delegation and workflows that fan work out across many agents with structured phases.

Long-running work — Plan mode to review and approve before execution, persisted goals that continue across rounds, and resumable sessions.

Model experience — DeepSeek models through the official API; session logs record everything a model sees so any run can be reconstructed.

Model control — Per-provider reasoning effort (off to max), maximum output tokens, and multimodal capability switches for image input, generation, and recognition.

Personalization — Theme and skin collection, selection-annotation workflow, command shortcuts, and an English/Chinese interface.

Plugin management — Install plugins from npm or a Git repository, check for updates, and enable or disable each plugin.

Recovery — A plugin that fails to load is reported with its diagnostics: disable that plugin, start in safe mode, or let the agent repair it with the failure context attached.

Archives — Search archived conversations and restore or permanently delete them.

Extensibility — New capabilities install without touching the app bundle.

Desktop integration — Tray icon, native notifications, one instance, and a hardened Electron window.

See the Web UI guide for a walkthrough and the desktop application guide for architecture, platform targets, and current limitations.

Download

Platform	Package
macOS Apple Silicon	DSHCode-*-macos-arm64.dmg
macOS Intel	DSHCode-*-macos-x64.dmg
Windows x64	DSHCode-*-win-x64.exe

Every release publishes SHA-256 checksums (SHA256SUMS.txt) next to the packages.

Preview packages are not code-signed or notarized, so macOS Gatekeeper and Windows SmartScreen may warn before first launch. The software is safe; the warning exists because the binary lacks a paid signing certificate:

• macOS: right-click the app in Finder and choose Open, then confirm in the dialog that appears. Alternatively run xattr -cr /Applications/DSHCode.app once in Terminal.
• Windows: click More info on the SmartScreen dialog, then Run anyway.

Quick start

Install a DSHCode package, then open DSHCode from the macOS Applications folder or the Windows Start menu. The application starts and stops its bundled Web profile itself; installed users never run a terminal command.

Run from source

Developers can run the upstream Web entry from a repository checkout:

git clone https://github.com/whitelonng/dshcode.git
cd dshcode
pnpm install
pnpm run build
pnpm dsh web

The command prints the local Web UI address. See the Web UI guide.

Desktop application

Opening DSHCode starts the bundled Harness Web profile and displays it in a hardened Electron window. The desktop shell is intentionally small; product behavior and the Web UI remain in the upstream packages so later upstream updates can be integrated without maintaining a second interface.

Local service and ports

Each launch starts an HTTP service inside the Electron main process. It binds only to 127.0.0.1 and asks the operating system for an available ephemeral port, so it reserves no fixed port and normally cannot conflict with another local service. DSHCode permits one application instance, loads only its exact loopback origin, and disposes the Harness tree before the process exits; closing the application stops the service and releases its port.

Build desktop packages

git clone https://github.com/whitelonng/dshcode.git
cd dshcode
pnpm install
pnpm run desktop:dist

Artifacts are written to .artifacts/desktop/release/. The Desktop GitHub Actions workflow builds macOS Apple Silicon, macOS Intel, and Windows x64 packages; a desktop-v* tag publishes the completed matrix and SHA-256 checksums to GitHub Releases.

FAQ

What is DSHCode?

DSHCode is a free, open-source desktop app that turns DeepSeek Harness — DeepSeek's plugin-based AI agent framework — into an installable macOS and Windows application with a graphical chat and workspace interface.

Is DSHCode official DeepSeek software?

No. DSHCode is an independent community project. It retains upstream package names, copyright, architecture, documentation, and an upstream Git remote so changes remain attributable and mergeable, but it is not a DeepSeek release, endorsement, or certification unless DeepSeek grants explicit authorization.

Do I need Node.js or a terminal?

No. Installed users get a normal application; Node.js, the CLI, and the terminal are only required for running from source or building packages.

Why does macOS/Windows show a security warning?

The preview packages are not code-signed or notarized. This is a certificate cost issue, not a safety issue; see the one-time steps in the Download section.

Do I need an API key?

Yes. DSHCode runs DeepSeek models through the official API; add your key once in the application settings.

Can I extend DSHCode?

Yes. The built-in plugin installer adds new capabilities without touching the app bundle, and a safe mode disables a crashing plugin so the application still starts.

Project positioning

DeepSeek Harness (dsh) is the official open-source plugin-based agent harness developed by DeepSeek AI. DSHCode participates in its plugin ecosystem as a desktop companion distribution and uses the dsh-plugin and deepseekharness-plugin repository topics for discovery.

DSHCode is an independent community project. Unless DeepSeek grants explicit authorization, it is not an official DeepSeek release, endorsement, or certification.

Development

Start with the development guide, architecture documentation, and desktop application guide. For agents, follow AGENTS.md.

Acknowledgements

• LINUX DO — This project is continuously shared and discussed in the LINUX DO community.
• dsh-genui — Provides the built-in generative UI plugin.
• dsh-annotation — Provides the built-in selection-annotation workflow.
• dsh-web-ui — Provides the built-in Web UI feature and skin collection.

License and branding

The source remains available under the upstream MIT License. Redistribution must retain DeepSeek's copyright and permission notice; bundled third-party software and licenses are disclosed in THIRD_PARTY_NOTICES.md, and the desktop package includes both files.

The MIT software license does not by itself grant permission to use DeepSeek trademarks or logos as DSHCode branding. DeepSeek's Terms of Use (Chinese version) reserve those brand features. DSHCode distributions use an independent application icon; upstream identity retained inside the embedded Harness interface and the official powered by dsh attribution identify compatibility, not endorsement.