How-to

How to use DeepSeek Harness

Step-by-step answers to the most common "how to" questions about dsh — each links to the full guide.

How to install DeepSeek Harness

Install Node.js LTS (18+), then run:

npx @deepseek-ai/dsh web

Open http://127.0.0.1:3080. Windows/macOS/Linux/WSL one-liners are in the install guide.

How to run your first task

  1. Start the web UI (npx @deepseek-ai/dsh web).
  2. Add your DeepSeek API key under Settings → Models.
  3. Click Choose workspace and pick a project directory.
  4. Send a task, e.g. Summarize this repository.

Full walkthrough in the tutorial.

How to install a plugin

dsh plugin --profile web add dsh-memory

Browse 122+ plugins with verified install results in the plugin directory.

How to build your own plugin

A plugin is one TypeScript module exporting apply(ctx), plus a cordis.patch.yml and a dsh.bundle manifest. Must be ESM. See the plugin guide for the full walkthrough.

How to migrate from Claude Code

Load your Claude skills/commands with dsh-claude-marketplace, import history with dsh-plugin-session-import:

dsh plugin add dsh-claude-marketplace

How to fix common errors

Every error we hit in real testing — ERR_PNPM_FETCH_404, ERR_REQUIRE_ESM, plugin-not-activating, and more — is in the troubleshooting guide.

🌐 中文