dushaobindoudou/dsh-selfrepair
Diagnoses a broken DSH install and repairs what it safely can: duplicate modules, unparsable settings and bad model defaults.
Targets the specific ways a DSH installation breaks, and it is deliberately split between repairs and reports. duplicate-modules is the important one: when a profile ends up with its own copy of packages that should come from the global install, you get two dependency-injection systems in one process and every agent preset fails to mount. The plugin relinks those onto the global version and backs up what it touched — the README explains the mechanism clearly, that pnpm installing a second real copy alongside each profile's lockfile-pinned copies means the split can arrive without anyone editing the profile, and that matching version numbers do not make the copy harmless because the harness's module graph only works as one instance per process. settings-yaml, agent-default-model and api-key are report-only on purpose: for those the tool cannot know what the damaged configuration was meant to say, so it shows the block that broke and leaves the decision to you. The settings page is read-mostly — opening it runs a check but never writes — and fix --only <check id> scopes a repair to a single check, with restore reversing any change.
Install
dsh plugin --profile web add dsh-recoveryThe one-command install from the README, which adds the package to a profile. The package is published twice from one repository — dsh-recovery is the primary name since 0.6.0 and dsh-selfrepair stays maintained for existing installs, with versions always matching — so the npm name in the command differs from the repository name and both names install the same code. A standalone global CLI (npm install -g dsh-recovery) works without any profile; there is also a documented manual npm install route for hosts without dsh plugin.
Compatibility
Node.js 20 or newer and the dsh CLI. One honest caveat the README puts in a blockquote: dsh doctor does not work on dsh 0.1.5-rc.2, because the stock 0.1.5 launcher only routes the web and plugin subcommands — the doctor route the README used to advertise was a local patch to the installed launcher, so use the CLI form this plugin ships instead. Every fix writes a backup, and only key names are ever read from credentials, never values.
Details
- Repo: dushaobindoudou/dsh-selfrepair
- Category: Tools & Capabilities
- Stars: 3
- Version: 0.6.1 (npm)
Alternatives
dushaobindoudou/dsh-hyperliquid · dushudou/dsh-web3 · DDDMUC/dsh-free-search