MIT-licensed, CodePilot-inspired desktop client and plugin suite for DeepSeek Harness — the Electron app wraps the Harness runtime, while its UI plugins install into any local dsh Web profile via the dsh CLI.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-21
License
MIT
01What can it help you accomplish?
Run the DeepSeek Harness runtime as a focused native desktop app with visual provider and model management
Desktop client on macOS, Windows and Linux with a CodePilot-inspired interface, provider/model management, workspace-aware conversation rows, and a Files right sidebar — no separate DeepSeek Harness installation required
DeepSeek Harness users who prefer a desktop web UI over the CLI-launched Web UI
Add the CodePilot theme, Files sidebar, reminder summary, or session-log export to a local DeepSeek Harness Web profile
Each feature installed with a single `dsh plugin --profile web add` command from a prebuilt dsh.bundle release asset — no repository clone, YAML patch, or local build required
Users of the stock DeepSeek Harness Web profile who want individual desktop-grade UI plugins
Export DeepSeek Harness sessions as ZIP archives
Per-Session ZIP export from the Trajectory toolbar and the `/export` command via the session-log export plugin
Teams that need archivable copies of agent sessions and trajectories
02How to install into DeepSeek Harness
Prerequisites
- macOS (Apple Silicon), Windows (x64), or Linux (x64) for the desktop app
- A local DeepSeek Harness Web profile with the dsh CLI only if installing the standalone plugins via `dsh plugin --profile web add`
Installation steps
- 01
Download the installer for your system from GitHub Releases: DMG/ZIP for macOS Apple Silicon, EXE for Windows x64, AppImage/DEB/RPM for Linux x64
- 02
macOS: open the DMG, drag pilot-harness.app into Applications, and launch it normally; if Gatekeeper blocks the first launch, use System Settings → Privacy & Security → Open Anyway
- 03
Windows: run the EXE; if SmartScreen warns, confirm the file came from the Release, then choose More info → Run anyway
- 04
Linux: `sudo apt install ./Pilot-Harness-Linux-amd64.deb`, `sudo dnf install ./Pilot-Harness-Linux-x86_64.rpm`, or `chmod +x` then run the AppImage
- 05
Open Pilot Harness, select a Workspace, then go to Settings → Providers to connect a provider and choose one of its available models
- 06
Standalone plugins: run `dsh plugin --profile web add <release tgz URL>` for the CodePilot theme, Files sidebar, reminder summary, or session-log export, then restart the Web profile
$ dsh plugin --profile web add <release tgz URL>
Verify the integration
- Restart the Web profile after plugin installation and use `dsh --profile web --dump-config` to confirm the added row
Rollback
- Remove a plugin with its package name, e.g. `dsh plugin --profile web remove @deepseek-ai/dsh-ui-worktree`; removing the CodePilot theme plugin restores the stock Harness presentation
03DSH integration and capability boundaries
Electron desktop app packaging the DeepSeek Harness plugin runtime as a native app, plus standalone UI plugins installed into local dsh Web profiles via `dsh plugin --profile web add`
Desktop shell around the Harness runtime
installer for macOS / Windows / Linux→native window wrapping the local DeepSeek Harness runtime, with directory dialog, startup recovery screen, and platform icons
CodePilot-inspired visual theme
CodePilot theme plugin (@deepseek-ai/dsh-client-ui-codepilot-theme)→consistent tokens, radii, menus, hover states, settings cards, Markdown rendering, and platform-aware title bars
applies the Pilot Harness product mark and visual overrides; disabling the theme row restores the stock Harness presentationWorkspace Files sidebar
Files plugin (@deepseek-ai/dsh-ui-worktree)→Workspace-confined right file sidebar with file count, branch summary, row actions, and @path insertion; project-aware conversation rows show branch, state, reminder summary, mode, and model details
Session-log export
session-log export plugin (@deepseek-ai/dsh-session-log-export)→per-Session ZIP export from the Trajectory toolbar and the /export command
writes ZIP export files to disk
04Who is it for? When not to use it?
Good for
- DeepSeek Harness users who prefer a desktop web UI over the CLI-launched Web UI
- Users of the stock DeepSeek Harness Web profile who want individual desktop-grade UI plugins
- Teams that need archivable copies of agent sessions and trajectories
Not for
- macOS notarization is not enabled yet, so Gatekeeper may block the first launch (Open Anyway is the expected extra step); Windows and Linux preview installers remain unsigned — never disable platform security globally.
- The Files sidebar and Reminder summary plugins require the Pilot Harness UI slot contracts included in Pilot Harness v0.1.0; older upstream Harness builds can install their bundles but cannot render those two UI contributions.
05Compatibility, maintenance and safety notes
- macOS notarization is not enabled yet, so Gatekeeper may block the first launch (Open Anyway is the expected extra step); Windows and Linux preview installers remain unsigned — never disable platform security globally.
- The Files sidebar and Reminder summary plugins require the Pilot Harness UI slot contracts included in Pilot Harness v0.1.0; older upstream Harness builds can install their bundles but cannot render those two UI contributions.
- Pilot Harness is an independent community project derived from the MIT-licensed DeepSeek Harness; it is not an official DeepSeek product and is not endorsed by or affiliated with DeepSeek.
MIT · actively maintained (latest release v0.1.0-rc.7-pilot.2, 2026-08-20)
06Frequently asked questions
How does Pilot Harness integrate with DeepSeek Harness?
Two ways. The desktop app packages the DeepSeek Harness plugin runtime inside Electron — the agent loop, Session log, tool pipeline, provider contracts, and RPC implementation stay untouched. Or install the individual UI plugins (theme, Files sidebar, reminder summary, session-log export) into a local Harness Web profile with `dsh plugin --profile web add`.
Do I need to install DeepSeek Harness separately?
No for the desktop app — the local Harness runtime is bundled. Just open Pilot Harness, select a Workspace, and connect a provider under Settings → Providers. The standalone plugins are only needed if you use a local DeepSeek Harness Web profile instead.
Why does macOS or Windows show a security warning on first launch?
macOS notarization is not enabled yet, so Gatekeeper may block the first launch — use System Settings → Privacy & Security → Open Anyway. Windows and Linux preview installers are unsigned. The README advises overriding only for files from the official GitHub Release and never disabling SmartScreen or Gatekeeper globally.
Are there version requirements for the standalone UI plugins?
The Files sidebar and Reminder summary plugins require the Pilot Harness UI slot contracts included in Pilot Harness v0.1.0. Older upstream Harness builds can install their bundles but cannot render those two UI contributions.
How do I remove a plugin or restore the stock interface?
Run `dsh plugin --profile web remove <package name>`, e.g. `dsh plugin --profile web remove @deepseek-ai/dsh-ui-worktree`. Removing the CodePilot theme plugin restores the stock Harness presentation.
07Related DSH workflows
dsh-web
by zhu1090093659
DeepSeek Harness (DSH) Web Plugin Aggregation Ecosystem · Everything is a plugin, distributed via the Creative Workshop
petdex
by crafter-station
A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.
j-space-cognition-suite-v3.7
by tiger3807861189
AI cognitive-enhancement skills for agent harnesses inspired by Anthropic's global workspace research. Adds inference-time control and reasoning tools for DeepSeek Harness, Claude Code, Codex and OpenCode.
dsh-deep-whale
by small-tailqwq
DSH Web GUI 鲸鱼娘主题皮肤(深海女仆工坊 maid-atelier:亮/暗双模式)
08Data and sources
Run the DeepSeek Harness plugin runtime as a focused native app, manage providers and multimodal models visually, and ke…
Pilot Harness does not replace the DeepSeek Harness agent loop, Session log, tool pipeline, provider contracts, or RPC i…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
