dsh-plugin-shop

The plugin shop for DeepSeek Harness — browse, install, enable, disable, and update dsh plugins, with every catalog change tracked in Git.

English | 中文

---

📦 Install the shop

Install the shop manually, or have an agent follow the automated steps below.

🧑 Manual installation

Prerequisite: Node.js. You can run DeepSeek Harness without a global installation using the command in its official documentation: npx -y @deepseek-ai/dsh web. Plugin management uses dsh plugin, which invokes both dsh and pnpm. Install these tools with npm install -g @deepseek-ai/dsh pnpm, then check that both are available with dsh --version and pnpm --version.

# With dsh installed globally, run the following command.
# Specify the version: pnpm 11 restricts newly published releases by default,
# so omitting the version may install an older release. The current version
# is shown below; check for updates with `npm view dsh-plugin-shop version`.
dsh plugin --profile web add [email protected]
# Alternatively, run the installation command through npx:
npx -y @deepseek-ai/dsh plugin --profile web add [email protected]

Replace web with your profile name if you use a different one. Restart dsh after installation to load the new plugin, then open:

Plugin shop in the left sidebar

🤖 Installation with an agent

An agent can run these steps without interaction. The --profile option is required. If it is omitted, dsh plugin exits with this error: error: required option '--profile <name>' not specified.

# 1. List available profiles ($DSH_HOME defaults to ~/.dsh; exclude node_modules).
ls -1 "${DSH_HOME:-$HOME/.dsh}/profiles" | grep -v '^node_modules$'

# 2. Specify the version to bypass pnpm's release cooldown and ensure
#    that the expected version is installed.
dsh plugin --profile <profile> add [email protected]

# 3. Verify the installation; exit code 0 above only means pnpm resolved the package.
dsh plugin --profile <profile> list --depth 0   # The output should include dsh-plugin-shop.

# 4. Restart the profile to load the new plugin.
dsh --profile <profile>

You can also verify step 3 by checking that dsh.profile.bundles in $DSH_HOME/profiles/<profile>/package.json includes the plugin. For troubleshooting, see the package README.

🖼️ Screenshots

✨ Highlights

• 🌐 Automatic discovery — the catalog collects npm packages with the dsh-plugin or deepseek-harness keyword and GitHub repositories with either topic. Authors do not need to submit an application or join a queue.
• 🧹 Strict screening — every candidate is checked automatically on each build. Rejected plugins are recorded by name with one of seventeen predefined reasons and a detailed explanation to help authors troubleshoot. The plugins and filtered badges above show the current totals.
• 🔌 Local dependency checks — the shop checks each peer dependency a plugin requires against your profile and the modules dsh's web client provides. When the author declares which dsh versions or profiles a plugin supports, the shop also compares them with what you run. A card shows Incompatible only when a dependency is missing from your environment or the author's declared support does not cover it.
• 🗓️ Daily updates — the catalog is rebuilt daily, with changes committed to Git for review. Eligible new plugins are listed the next morning, and plugins whose repositories are no longer available are removed during the same process.
• 🗂️ Seven categories — authors can choose a category through dsh.catalog. Otherwise, the build assigns one automatically.
• 🎨 Icons from the package — every card and installed row draws the plugin's own icon, with the shop's default artwork when a package declares none.
• 🖥️ A layout that uses the width — on a wide tab the controls become a sticky filter rail beside a two-column card grid; narrower tabs keep the wrapping category chips and gain two columns as soon as they fit.
• 🐞 Failures you can report — a failed install offers a prefilled GitHub issue against the plugin's own repository: what you did, the host's detail and the last 20 log lines. A repository the shop cannot recognise gets no link, because a report on the wrong repository is worse than none.
• 🔄 A shelf that keeps up — returning to the shop's tab refreshes the catalog, at most once every five minutes; a failed refresh keeps the shelf you were reading.

🗺️ How it works

The catalog is built daily in this repository. The build code lives in registry/.

This is the beginning of the README. Read the rest at the original. Read the full README ↗