deepseekplugins

DeepSeek Harness plugin

dsh-self-update

In-app self-update for DeepSeek Harness git-source installs (check / one-click update / rollback / restart), with an optional native macOS shell.

Tools & Capabilities
Jump to install

Source facts

Repository
Shane-Jay/dsh-self-update
Latest update
Aug 20, 2026
Category
Tools & Capabilities
GitHub stars
2
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-21

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Shane-Jay/dsh-self-update
Plugin: dsh-self-update
Author: Shane-Jay

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

<div align="center">

dsh-self-update

English | 简体中文

In-app self-update for DeepSeek Harness git-source installs — with an optional native macOS shell.

![npm version](https://www.npmjs.com/package/dsh-self-update) ![License: MIT](LICENSE) ![DSH core](https://www.npmjs.com/package/@deepseek-ai/dsh)

<img src="docs/assets/update-panel.png" alt="Update panel: current vs. new version, the three steps about to run, and a one-click Update button" width="760">

</div>

What is this?

If you run DeepSeek Harness from a git checkout (git clone + pnpm dsh web) — the way most self-hosted setups do — there is no built-in way to update it. Every release means manually running git pull, pnpm install, pnpm build, then restarting the service, and if anything breaks you dig out the old commit by hand.

dsh-self-update turns that whole cycle into a button. It is a harness plugin that:

  • checks quietly in the background (every 6 h by default) and on demand, from the settings page or the macOS menu bar;
  • shows a "new version" entry in the sidebar when there is something to install — clicking it opens an update panel with a version comparison and exactly the three commands about to run;
  • installs in one click: git pull --ff-only → pnpm install → pnpm build, with live per-step progress;
  • refuses to touch a dirty or diverged working tree — it will never discard your local changes;
  • rolls back in one click if a step fails (and ships a CLI fallback for when the UI itself is down);
  • restarts the service through a simple contract: the process exits with code 75, and your supervisor — systemd, PM2, or the bundled macOS shell — brings it back up.

Not for you if you installed dsh via npm i -g @deepseek-ai/dsh: there is no git working copy to update, so this plugin hides itself entirely. Use an npm-based updater such as dsh-update-checker instead.

Install (any platform)

cd <your-deepseek-harness-checkout>
pnpm dsh plugin --profile web add dsh-self-update

Restart the dsh service once and you are done. No configuration needed — the plugin uses the process working directory as the harness checkout (override with the plugin config repoRoot if yours differs).

Closing the restart loop

The Restart now button makes the process exit with code 75 ("please restart me"). Teach your supervisor to honor it:

RunnerConfig
systemdRestartForceExitStatus=75
PM2autorestart: true (the default)
macOS shell (below)built in
bare terminaljust run pnpm dsh web again

macOS shell (optional)

A native Swift + WKWebView app (no Electron) that owns the dsh service: click the icon to open the UI, closing the window keeps the service running, ⌘Q stops it. It adds a "Check for Updates…" menu item that opens the in-app update panel, and it automatically relaunches the service when it exits with code 75.

node macapp/build-mac-app.mjs        # requires Xcode command line tools
# outputs ~/Applications/DSH.app

First launch: right-click → Open (the app is ad-hoc signed, not notarized).

How it compares

UpdatesPlatformsAuto-restart
dsh-update-checkernpm packagesrestart is Windows-only✅ (Win)
dsh-update-copilotplugins; core is report-onlyall❌
dsh-self-updatethe harness git checkout itselfall (restart incl. macOS/Linux)✅ (exit-code 75 contract)

The exit-code-75 restart contract is the piece the community has been asking the harness core for (see upstream discussions #1231 and #2717) — this plugin is a working implementation of it.

Interface contract

  • HTTP — /self-update/api/update/{status,check,install,rollback,restart}. Write routes require Content-Type: application/json and a local Origin (CSRF line of defense).
  • Panel event — dispatch dsh-self-update:open on window (detail: { check: true } to check immediately). This is exactly what the macOS menu item does via evaluateJavaScript.
  • Restart — process exit code 75 means "restart requested". Anything else is a crash.
  • State — persisted at ~/.dsh-self-update/update-state.json.

When the UI is gone

If an update leaves dsh unable to boot (plugin/core seam breakage), the Web UI — rollback button included — is gone with it. Fall back to the CLI:

node scripts/rollback-harness.mjs          # target = previousSha from the state file
node scripts/rollback-harness.mjs --sha <commit>   # or pick a commit yourself

The updater records previousSha before every install precisely for this moment.

Development

Sibling layout, same as the rest of the dsh plugin ecosystem: this repo must be checked out next to deepseek-harness — the @deepseek-ai/* dev dependencies are link:../deepseek-harness/....

pnpm install
pnpm typecheck && pnpm test && pnpm build

The updater test suite runs against real (offline) git repositories; only the install/build commands are stubbed.

License

[MIT](LICENSE)

---

![](https://github.com/deepseek-ai/deepseek-harness)

Back to searchOpen GitHub repository

More related plugins

View category