dsh-plugins
Monorepo of plugins for DeepSeek Harness (dsh). Each plugin is a separate
npm package with a dsh.bundle.patch manifest, so plugins can be installed
selectively from a single repository and are automatically added to the
profile (no manual cordis.patch.yml editing).
Structure
dsh-plugins/
├── package.json # root: workspaces, private
├── pnpm-workspace.yaml
├── scripts/check.mjs # node --check over all src/*
└── packages/
├── dsh-plugin-a/ # @blake-r/dsh-plugin-a
└── dsh-plugin-b/ # @blake-r/dsh-plugin-b
Plugins
| Package | What it does |
|---|---|
| dsh-assembly-rewrite | Rewrite named system-prompt assembly inserts (tools, sections, contexts, variables) from config. |
| dsh-assembly-tools-prompt-strip | Drop the tool:<name> prose guidance sections from the system prompt. |
| dsh-client-ui-archived-session-cleanup | Settings control to delete archived sessions older than N days, with a live preview (host remote service + browser section). |
| dsh-client-ui-wider-chat | Widen the conversation output column to near-full width while keeping the composer card at its current width. |
| dsh-command-from-prompt | Generic "command = user prompt" slash-command plugin. |
| dsh-command-status-interrupt | A /status command that aborts the running generation and asks the model for a progress report without opening a new turn or a user bubble. |
| dsh-compaction-micro | Per-request trajectory re-composition. |
| dsh-host-prompt-variables-config | Register extra prompt variables so they can be referenced as {{name}} in any system-prompt section. |
| dsh-loop-guard | One package, two plugin rows: a reasoning-loop guard and a repeat-pattern reminder, sharing an internal coordination module. |
| dsh-spill-policy | Replacement spill policy: bound oversized model-facing tool results to a head/tail preview plus a spill notice. |
| dsh-provider-websearch-lightpanda | WebRuntime provider pair backed by the lightpanda MCP server. |
| dsh-skill-from-tools | Tools stay directly invocable; one skill per tool holds full details. |
| dsh-tool-filter-root-find | Gates tool calls that sweep the whole disk or home directory. |
| dsh-tool-mcp-mutation-gate | MCP command filter that asks the user for confirmation before executing a server's mutating tools. |
| dsh-tool-node | node_run / node_npm tools confined through the DSH sandbox seam. |
| dsh-tool-python | py_run / py_pip tools over a per-workspace venv, with on-the-fly repair of a relocated venv. |
| dsh-tool-trajectory-recall | Model-facing same-session recall/search tools over the durable session log. |
How it works
Each package declares in package.json:
"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
and ships a cordis.patch.yml file (a YAML list of rows with insert).
The dsh plugin --profile web add <pkg> command installs the package and, via
reconcilePlugins, itself adds it to dsh.profile.bundles — the plugin is
activated without manual edits.
Install (selective, local)
cd <dsh-checkout>
dsh plugin --profile web add ./packages/dsh-plugin-a
# only dsh-plugin-a; dsh-plugin-b is not installed
pnpm add ./path creates a symlink to the local folder — convenient for development.
Install (external users)
# from the npm registry (recommended for selectivity from one repo)
dsh plugin --profile web add @blake-r/dsh-plugin-a
# from a GitHub repository, a single plugin subdirectory (tag = version)
dsh plugin --profile web add github:blake-r/dsh-plugins#path:packages/dsh-plugin-a
# from a GitHub repository, the whole repo root (tag = version)
dsh plugin --profile web add github:blake-r/dsh-plugins#v1.0.0
About
github:: thegithub:protocol installs the repository root by default. To install a single plugin from this monorepo, point at its subdirectory with#path:packages/<name>(as shown above). For the most selective install from one repo, publish the packages to npm (pnpm -r publish) and install by name.
Publishing
pnpm install
pnpm check # node --check over all src/*
pnpm -r publish # publish all packages to npm
npm versions should match git tags vX.Y.Z.
Adding a new plugin
- Copy
packages/dsh-plugin-a→packages/dsh-plugin-<name>. - Change
name(scope@blake-r/dsh-<name>),version,description. - Write the logic in
src/index.js(ESM, exportname+apply(ctx)). - Update
cordis.patch.yml(row id and name). pnpm checkandpnpm -r publish.
Notes
- Plugin files are ESM (
.mjs); check withnode --check. - The package's
cordis.patch.ymlmust be infiles(otherwise it won't be published).
No comments yet. Be the first to write one.