How do I install a DSH plugin?

Run 'dsh plugin add github:owner/repo' in your DeepSeek Harness terminal. The CLI resolves the plugin from GitHub, verifies its provenance, and installs it into your active profile.

Where do DSH plugins come from?

DSH plugins are installed from three sources: GitHub repositories (the most common, found via the 'dsh-plugin' topic), the npm registry (published packages), and local directories (for development).

Why does my plugin install ask for build approval?

GitHub-sourced plugins may run build scripts at install time. DeepSeek Harness asks for approval so you can review what the plugin will run before allowing it.

How do I uninstall a DSH plugin?

Use 'dsh plugin remove ' or remove it from the plugins list in the web UI, then restart the harness.

How to Install DeepSeek Harness (DSH) Plugins: A Step-by-Step Guide

Installing a DSH plugin (a DeepSeek Harness plugin) is a one-command operation — once DeepSeek Harness itself is installed. This guide covers all three installation sources: GitHub, npm, and local directories.

Before you start: install DeepSeek Harness

npm install -g @deepseek-ai/dsh
npx @deepseek-ai/dsh web

The web UI opens at http://127.0.0.1:3080. The dsh command is available in your terminal from this point.

Method 1: Install a DSH plugin from GitHub (most common)

Community plugins are hosted on GitHub and discovered through the dsh-plugin topic. Every plugin page in this directory shows its exact command:

dsh plugin add github:owner/repo

Example — install the regex tool plugin:

dsh plugin add github:omdsh-dev/dsh-tool-regex

The CLI will:

Resolve the repository and check that it declares a plugin.
Verify provenance (who owns it, what it will run).
Install the plugin into your active profile.

For reproducible installs, pin a commit hash:

dsh plugin add github:omdsh-dev/dsh-tool-regex#ec533420e133

Method 2: Install a DSH plugin from npm

Plugins published to the npm registry can be installed by package name:

dsh plugin add @scope/package-name

npm-sourced plugins are subject to the same provenance checks as GitHub-sourced ones.

Method 3: Install a local DSH plugin (development)

If you are building your own plugin, install it directly from the folder:

dsh plugin add ./path/to/your-plugin

Local installs skip the network fetch, which makes them ideal for the development loop. See how to build a DSH plugin for the full tutorial.

Verify the installation

dsh plugins list

You should see your plugin in the output. Some plugins require a harness restart to activate — restart the web UI if a plugin does not appear in the interface right away.

Troubleshooting common problems

Problem	Fix
“Build approval required”	Review what the plugin will run, then approve. Only install plugins you trust.
Plugin not found	Make sure the repository is public and tagged with the `dsh-plugin` topic.
Command not recognized	Reinstall the CLI: `npm install -g @deepseek-ai/dsh`, then open a new terminal.
Want to uninstall	`dsh plugin remove <name>`, then restart the harness.

The one-line summary

dsh plugin add github:owner/repo installs any community DSH plugin. Browse the plugin directory to find curated plugins with verified install commands, and check the safety guide before installing from unknown sources.