Back to directory

pilot-harness

Curated pickMaintenance: Active

op7418/pilot-harness

Pilot Harness — a CodePilot-inspired desktop client and plugin suite for DeepSeek Harness on macOS, Windows, and Linux.

View on GitHub
$ dsh plugin --profile web add <release tgz URL>

271

stars

19

forks

TypeScript

Language

MIT

License

2026-08-17

Created

2026-08-20

Last push

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

  1. 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

  2. 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

  3. 03

    Windows: run the EXE; if SmartScreen warns, confirm the file came from the Release, then choose More info → Run anyway

  4. 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

  5. 05

    Open Pilot Harness, select a Workspace, then go to Settings → Providers to connect a provider and choose one of its available models

  6. 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

DSH integrationNative runtime

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 / Linuxnative 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 presentation
  • Workspace 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.
2026-08-172026-08-18v0.1.0-rc.7-pilot.2

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.

08Data and sources

  • Author-claimedgithub.comd1fa9c15fc00…

    Run the DeepSeek Harness plugin runtime as a focused native app, manage providers and multimodal models visually, and ke…

  • Author-claimedgithub.comd1fa9c15fc00…

    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.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.