DSH Codex Desktop is a community-maintained desktop distribution of DeepSeek Harness. It is not an official DeepSeek AI product.

DSH Codex Desktop turns DeepSeek Harness into a native, ready-to-run desktop workbench. The installer includes the required Node.js runtime and local DSH runtime: install it, open it, then start working. You do not need to prepare a Node.js environment or launch DSH from a terminal.

Download and start

Get the current installer from GitHub Releases.

Platform	Package	Start here
Windows x64	.exe installer or .zip archive	Run the installer, then open DSH Codex Desktop from the Start menu.
macOS Apple Silicon / Intel	.dmg installer	Open the disk image, move the app to Applications, then launch it.
Linux x64 / ARM64	.AppImage or Debian / Ubuntu .deb	Run the package matching your CPU architecture, or install the deb package, then launch the app.

1. Download the package for your platform.
2. Install and open DSH Codex Desktop.
3. Wait for the built-in local DSH service to finish starting.
4. Create a task, select a model and permission mode, then work in your project.

The application keeps DSH data in your existing user profile (%USERPROFILE%\.dsh on Windows), so sessions and settings remain available after application upgrades.

A complete desktop workbench

Capability	What you get
Desktop conversation workspace	Project and task navigation, conversation sessions, model selection, permissions, session logs, and a focused desktop window.
Expert presets	Enable specialist roles for code review, architecture, frontend, backend, operations, and other workflows.
Skill center	Inspect, enable, disable, upload, and manage local and shared Agent skills from Settings.
Archive management	Search archived conversations, restore a session when needed, or permanently remove archived records.
IM assistant	Configure DingTalk, Feishu, Lark, WeChat, WeCom, QQ, Telegram, and other available channels in one place.
Plugin market	Discover, install, update, enable, and diagnose DSH plugins without leaving the desktop client.
MCP connector	Add and manage MCP services through OAuth, API keys, HTTP, stdio, or JSON configuration.
Scheduled automation	Use the built-in DSH scheduling capability to manage recurring tasks from the same workspace.
Safe local runtime	The app starts DSH on a validated loopback address and keeps the browser UI inside the desktop shell.

Product preview

Dark workspace: project context, a long-running task, and the desktop conversation surface.

Light workspace: the same task surface in the light theme.

Inspect context composition while the extensible workspace sidebar keeps project files within reach.

Archived conversations stay searchable and can be restored from Settings.

Manage the skills available to DSH and your Agents.

Connect channels for IM-assisted workflows.

Enable only the expert presets that match the current task.

Included on first launch

The installer ships with the local runtime required to start DSH. On first launch, it prepares the desktop-facing community plugins in the Web profile:

Included capability	Package
Codex-style workspace UI	@michengai/dsh-codex-ui
Expert preset management	@michengai/dsh-agency-agents
Skill management	@michengai/dsh-skills-manager
Archive management	@michengai/dsh-archive-manager
IM assistant	@michengai/dsh-im-connect
Scheduled automation	@michengai/dsh-automation
Context inspection and management	dsh-context
Extensible workspace sidebar	dsh-better-sidebar
MCP connection management	dsh-mcp-connector

You can later manage additional plugins from the plugin market. The desktop application keeps its own runtime separate from profile-installed community plugins so plugin changes do not overwrite the application runtime.

DSH product ecosystem

DSH Codex Desktop combines the core runtime, feature products, and plugin market into a ready-to-install desktop product. The same products can also be used separately for other DSH setups:

Product	Primary role	Relationship to the desktop app
DeepSeek Harness	Models, sessions, tools, and plugin runtime	The core runtime bundled and started by the desktop app
DSH Codex Desktop	Cross-platform workbench for end users	This product, responsible for ready-to-run installation, updates, and recovery
Six feature products	Codex UI · IM Connect · Automation · Skills Manager · Archive Manager · Agency Agents	Each can be installed independently; all six are bundled with the desktop app
Integrated ecosystem plugins	DSH Context · DSH Better Sidebar · DSH MCP Connector	Bundled with the desktop app for context insight, workspace navigation, and MCP connection management
dshmarket	Discover, install, and update more DSH plugins	Included as the plugin market

Updates and recovery

• Desktop updates are checked after startup by default and notify you when a new release is available. Settings → Updates can instead download releases automatically or switch to manual-only checks. Installation and restart always require an explicit action.
• DSH reload is available from the tray menu after changing plugins or profile configuration; it restarts the local DSH service without reinstalling the desktop application.
• Plugin updates remain in the DSH settings and plugin market. A failed plugin installation is not activated as a running bundle.
• Startup recovery removes stale community-plugin registrations that no longer have an installed package, then retries the local DSH startup.

System requirements

Item	Requirement
Operating system	Windows 10/11, macOS, or Linux
Architecture	Windows x64, macOS arm64/x64, or Linux x64/arm64
Node.js	Not required for end users; bundled with the application
Network	Required only for the model providers, plugin downloads, and tools you choose to use

Privacy and security

• DSH configuration, sessions, and credentials remain in the current user's DSH directory. Uninstalling the desktop app does not delete them.
• The launcher accepts only validated 127.0.0.1 local HTTP addresses for its embedded window.
• External HTTP(S) links open in the system browser. File, JavaScript, and data URLs are blocked.
• Electron uses context isolation and sandboxing, with Node.js integration disabled for the DSH page.
• Your configured model providers and DSH tools may make their own network requests. Review their settings and privacy policies before use.

Development

Development requires Windows, Node.js 24.20.0, and pnpm 11.24.0.

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm install --frozen-lockfile
pnpm test
pnpm run dist

Local build artifacts are written to release\ and are not committed. Pushing a vX.Y.Z tag starts the packaging workflow for Windows x64, macOS arm64/x64, and Linux x64/arm64 AppImage / deb artifacts.

Project documentation

For current status, architecture constraints, and iteration records, start at the documentation entry point.

License

This project is licensed under Apache License 2.0.

Changelog

See CHANGELOG.md for the five most recent releases.