DSH Plugins
A master repository for DeepSeek Harness plugins. Each plugin remains an independent Git repository and is included here as a Git submodule, so plugin history, branches, releases, and CI stay isolated.
Plugins
dsh-all-in-one
This repository also publishes dsh-all-in-one, an aggregate DSH bundle that
installs every web plugin of the collection in one step and mounts them as a
single bundle layer:
# published channel
dsh plugin --profile <name> add dsh-all-in-one
# or pinned straight from this repository's releases
dsh plugin --profile <name> add https://github.com/leonardoxr/dsh-plugins/releases/download/v<version>/dsh-all-in-one-<version>.tgz
Properties:
-
One row per plugin, canonical IDs. Each aggregated plugin keeps the same
Cordis row ID its standalone bundle uses, so profile-patch config overrides
keep working unchanged when migrating from the standalones to all-in-one.
-
Either/or — never both. The suite replaces the standalone bundles.
Mounting a standalone bundle and the suite together is boot-fatal by loader
design ("duplicate loader entry id", even if one row is disabled). Remove
the standalone installs before adding the suite. Every insert also carries
a !!js back-off guard against earlier same-package mounts under a
different ID; install the all-in-one last (dsh plugin add does this
automatically) so guards can see everything mounted before it.
-
Generated, never hand-edited. aggregate.yml is the single source of
truth; package.json dependencies and cordis.patch.yml are produced by
scripts/aggregate.mjs:
pnpm generate # regenerate both outputs from aggregate.yml
pnpm verify # fail when outputs drifted (runs on prepack too)
-
Per-plugin opt-out survives aggregation. Users can still disable any
subset in their profile patch (- id: <row-id> + disabled: true).
Dependency pins use exact npm versions where packages are published, and
GitHub Release tarball URLs otherwise; flip a pin to npm by editing its
channel/spec in aggregate.yml and regenerating.
| dsh-harness-updater | leonardoxr/dsh-harness-updater | Claude Code / Codex CLI update detection and one-click updates |
| dsh-image-preview | leonardoxr/dsh-image-preview | Inline image previews and clipboard copying |
| dsh-plugin-manager | leonardoxr/dsh-plugin-manager | Profile plugin management |
| dsh-companion | leonardoxr/dsh-companion | Read-only workspace/session API and notifications |
| dsh-native | leonardoxr/dsh-native | Native desktop and mobile shell for DSH web servers |
| dsh-routed-subagent | leonardoxr/dsh-routed-subagent | Complexity-routed subagent delegation |
| dsh-workspace-git | leonardoxr/dsh-workspace-git | Workspace Git integration |
Repository model
- This repository coordinates the plugin collection; it does not merge their histories.
- Plugin directories are independent Git repositories. Use
git -C <plugin> ... for plugin work.
- Update the pinned plugin revision in the master repo with
git -C <plugin> pull followed by git add <plugin>.
- Do not commit DSH source changes here or inside a plugin. Plugins must be mounted through the DSH profile and
cordis.patch.yml mechanism.
- Code changes follow each plugin’s contribution rules; documentation-only collection changes may be made here.
DSH plugin behavior
Plugins are Cordis modules with optional host and client halves. The package manifest declares the DSH bundle patch and client injection metadata. Host code must use public DSH services/routes; client code must use injected services and must unload cleanly.
For better-sidebar integrations, see dsh-better-sidebar/AGENTS.md. Key rules: use inject = ['betterSidebar'], register tabs/viewers through ctx.betterSidebar, wrap registration in ctx.effect() so the disposer is HMR-safe, use package-prefixed IDs, and keep dsh-better-sidebar as an optional peer dependency. The service exists only on the client side.
Local development
# Clone this collection with plugin repositories
git clone --recurse-submodules <master-repository-url> dsh-plugins
# Initialize plugins after a normal clone
git submodule update --init --recursive
# Work inside one plugin
cd dsh-better-sidebar
pnpm install
pnpm build
Install a local plugin into a DSH web profile using the official plugin mechanism, then refresh the existing DSH UI. Do not modify the DSH checkout.
Documentation references
