Upgrading and uninstalling plugins

After this tutorial you will

• See which plugins you have installed
• Upgrade a single plugin, all plugins, and DSH itself
• Uninstall plugins cleanly
• Reset or remove DeepSeek Harness entirely when needed

Everything happens in the terminal, always in the shape dsh plugin --profile web <action> — think of it as the plugin remote control.

See what's installed

dsh plugin --profile web ls

This lists every installed plugin in the current profile with its version. Running it before any upgrade is a good habit.

Upgrade plugins

Upgrade one plugin (open-design as the example):

dsh plugin --profile web update @deepseek-ai/open-design

Use the exact package names shown by ls — some plugin package names differ slightly from their repository names.

Upgrade everything at once:

dsh plugin --profile web update --latest

update --latest bumps every plugin to its newest version. Plugins occasionally conflict, so if something misbehaves after a bulk upgrade, check the FAQ before deciding to roll back.

Restart dsh after upgrading for changes to take effect (as always: Ctrl + C, then dsh web).

Uninstall a plugin

dsh plugin --profile web remove @deepseek-ai/open-design

remove deletes both the dependency and its configuration layer — nothing lingers. A restart applies the change here too.

Not sure of the exact package name? Check with ls first, or use tab completion in the terminal.

Upgrade DSH itself

Two cases:

Running via npx (no global install) — add @latest to grab the newest release:

npx @deepseek-ai/dsh@latest web

Globally installed:

npm update -g @deepseek-ai/dsh

Upgrading dsh does not touch your plugins or settings — they live under ~/.dsh, separate from the program itself.

Deep clean: reset and full uninstall

Reset one profile (clears its plugins, back to factory state):

# 1. Quit dsh first, then run:
rm -rf ~/.dsh/profiles/web
# 2. The next `dsh web` rebuilds a fresh web profile automatically

Completely uninstall DeepSeek Harness:

# 1. Stop the running dsh (Ctrl + C)

# 2. Uninstall the global package (if you installed one)
npm uninstall -g @deepseek-ai/dsh

# 3. Delete all data (config, plugins, session logs, keys)
rm -rf ~/.dsh

On Windows, replace step 3 with: open Explorer at C:\Users\<you>\ and delete the .dsh folder.

Want to keep your session history? Copy the whole ~/.dsh directory somewhere safe before deleting it.

A good maintenance rhythm

DSH is still iterating quickly. A sane cadence:

1. Upgrade plugins on demand: fix what's broken, skip the novelty chase;
2. Upgrade the core monthly: one quick command, batch up the improvements;
3. Skim release notes on major versions: the official repository Release notes are worth a read.

Next up

That completes the trilogy: installed, configured, maintained. If you're itching to contribute something back to the ecosystem, the next lesson shows you how to write a plugin; if you'd rather just use it, dig through the FAQ for the remaining puzzles:

Write your own plugin →