dsh-plugins

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

• DeepSeek Harness
• DSH plugin registry
• better-sidebar consumer guide