Native DSH plugin that runs DeepSeek Harness agent sessions inside a local WSL distribution — bash and files on Linux paths, Windows reachable via /mnt/<drive>, nothing installed in WSL.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-03
License
MIT
01What can it help you accomplish?
Run a full DeepSeek Harness agent session inside a local WSL distribution
An agent session whose bash commands and file reads/writes run on Linux paths inside WSL, while Windows files stay reachable through /mnt/<drive>
DeepSeek Harness (dsh) users on Windows who want a Linux sandbox for agent bash and file work without installing dsh inside WSL
Add a WSL workspace to DeepSeek Harness directly from the web GUI
A configured WSL workspace the model opens as Linux paths, with a bilingual mode picker (e.g. WSL · Standard mode（标准模式）) and an optional per-distribution username
Developers who run DeepSeek Harness web and want to open WSL projects from the sidebar without any CLI setup
02How to install into DeepSeek Harness
Installation steps
- 01
Install from the npm package: `dsh plugin --profile web add dsh-wsl-workspace`
$ dsh plugin --profile web add dsh-wsl-workspace
- 02
Install from the GitHub repository (ships the prebuilt lib/, no local build required): `dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace`
$ dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace
- 03
Install from a local directory (development / self-hosted): `dsh plugin --profile web add <local-path>`
$ dsh plugin --profile web add <local-path>
- 04
Restart `dsh web` after adding the plugin
$ dsh web
Verify the integration
- After restarting `dsh web`, a W button appears beside Settings at the sidebar foot.
- In the Add WSL workspace dialog, use the Check button to verify a path exists before creating the workspace.
03DSH integration and capability boundaries
Native DSH plugin installed via the official dsh CLI (`dsh plugin --profile web add`); adds a WSL workspace type to the DeepSeek Harness web GUI and runs agent sessions inside a local WSL distribution.
Add WSL workspace from the GUI
DeepSeek Harness web sidebar; a chosen WSL distribution and an absolute Linux path (or a browsed directory)→A new WSL workspace the model can open, with the dialog following the DeepSeek Harness UI language
Bash and files run on WSL Linux paths
An agent session in a WSL workspace→bash commands run inside the WSL distribution; `read`/`write`/`edit` operate on WSL files, so every path the model sees is a Linux path
Per-workspace skill catalog discovery
A registered WSL workspace root→Skills discovered from the nearest `.git` ancestor, scanning `.dsh/skills` and `.agents/skills`, bounded to 4 levels / 64 dirs / 4096 dirs, cached per scan root
04Who is it for? When not to use it?
Good for
- DeepSeek Harness (dsh) users on Windows who want a Linux sandbox for agent bash and file work without installing dsh inside WSL
- Developers who run DeepSeek Harness web and want to open WSL projects from the sidebar without any CLI setup
Not for
- The Windows ACL sandbox cannot wrap `wsl.exe` — its children run on the Linux kernel side — so WSL itself is the isolation boundary and the DSH file policy does not apply to bash. Treat WSL as the trust boundary for bash commands.
- Under `workspace-write`, reads work anywhere but writes are restricted to the session workspace; switch the file policy to `danger-full-access` to allow writes outside it. The username field does not affect the file tools.
05Compatibility, maintenance and safety notes
- The Windows ACL sandbox cannot wrap `wsl.exe` — its children run on the Linux kernel side — so WSL itself is the isolation boundary and the DSH file policy does not apply to bash. Treat WSL as the trust boundary for bash commands.
- Under `workspace-write`, reads work anywhere but writes are restricted to the session workspace; switch the file policy to `danger-full-access` to allow writes outside it. The username field does not affect the file tools.
- The Windows-side `\\wsl.localhost` share cannot resolve Linux symlinks, so a project linked into the workspace via `ln -s` is not discoverable — register the workspace at a level that contains the real project directories.
MIT · maintainer claims native DSH plugin integration (topics: dsh, dsh-plugin, dsh-plugins); latest release 0.4.2 (2026-09-02)
06Frequently asked questions
How do I install dsh-wsl-workspace for DeepSeek Harness?
Run `dsh plugin --profile web add dsh-wsl-workspace` (npm), or `dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace` (GitHub, ships prebuilt lib/), or point it at a local directory. Then restart `dsh web` — a W button appears beside Settings.
Does the plugin require installing dsh inside WSL?
No. The README states nothing needs to be installed inside WSL; the session runs bash and file tools against a local WSL distribution while dsh stays on the Windows side.
Can the agent reach Windows files from inside the WSL session?
Yes. Bash runs inside the WSL distribution, but Windows files stay accessible via `/mnt/<drive>` (for example `/mnt/c/Users/...`), so the session can reach both WSL and Windows at the same time.
How does the WSL workspace affect the DSH file policy?
The Windows ACL sandbox cannot wrap `wsl.exe`, so WSL itself is the isolation boundary and the DSH file policy does not apply to bash. File tools (`read`/`write`/`edit`) go through the Windows-side WSL share and run under the DSH file policy; under `workspace-write`, writes are limited to the session workspace unless you switch to `danger-full-access`.
07Related DSH workflows
open-design
by nexu-io
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / DeepSeek Harness / OpenCode & 20+ CLIs via BYOK.
picgo
by molunerfinn
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosting services (S3, GitHub, Cloudflare R2, Imgur, Aliyun OSS...). Paste, upload, done.
dsh-desktop
by anywhere-labs
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem. Everything is a plugin — even the desktop shell itself.
openbiliclaw
by whiteguo233
Local-first, open-source AI content discovery agent that learns your taste and proactively finds content across Bilibili, Douyin, YouTube, Reddit, X and the open web.
08Data and sources
Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/wri…
dsh plugin --profile web add dsh-wsl-workspace
`dsh.compatibility.dshReleases` declares per-release compatibility with the official DSH versions
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-03. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.