6Mikao9/dsh-wsl-workspace
51Last commit Aug 15, 2026
dsh-wsl-workspace DSH plugin
dsh-wsl-workspace lets you add a WSL workspace from the DeepSeek Harness web GUI and run the entire agent session — bash commands and file reads/writes — inside a local WSL distribution. No installation is needed inside WSL. The session can reach both WSL and Windows simultaneously: bash commands run inside the WSL distribution, while Windows files remain accessible via /mnt/<drive>.
How to install the dsh-wsl-workspace DSH plugin
dsh plugin --profile web add dsh-wsl-workspaceCopying does not run this command. Review the repository and version before installing the dsh-wsl-workspace DSH plugin.
dsh-wsl-workspace DSH plugin data source
dsh-wsl-workspace DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-wsl-workspace DSH plugin can do
- Add a WSL workspace from the DeepSeek Harness web GUI via a dedicated W button.
- Run bash commands inside a chosen WSL distribution as the configured user (default or specified).
- File tools (read/write/edit) operate on WSL files with Linux paths, while Windows files stay reachable under /mnt/<drive>.
- Select a specific Linux user for the bash tool; leave empty to use the distribution's default user.
- Mode picker includes WSL variants (Standard, PTC, Minimal, Creative) that automatically switch to WSL mode.
- Workspace username is stored in a JSON file for persistence; can be reset by deleting the entry or recreating the workspace.
Where the dsh-wsl-workspace DSH plugin fits
- Develop and test Linux applications entirely within a WSL environment using DeepSeek Harness agent capabilities.
- Run bash scripts that require a Linux environment while still having direct access to Windows files and system.
- Create cross-platform workflows where the agent can execute commands inside WSL and read/write files on both Linux and Windows paths.
- Manage multiple WSL distributions and workspaces from a single DSH web interface.
Who the dsh-wsl-workspace DSH plugin is for
- DSH users who need a Linux environment for agent tasks and already use WSL on Windows.
- Developers who want to run agent sessions in a local WSL distribution without installing extra tools inside WSL.
dsh-wsl-workspace DSH plugin limitations
- The bash tool runs outside the DSH file policy because wsl.exe cannot be wrapped by the Windows ACL sandbox; isolation relies on WSL itself.
- File tools (read/write/edit) go through the Windows-side WSL 9P share and are subject to the DSH file policy; the username field does not affect file tools.
- The wsl.exe may print a garbled localhost port-forwarding banner to stderr when the distribution was not yet running, but it is harmless.
dsh-wsl-workspace DSH plugin: from the repository README
Quoted from the 6Mikao9/dsh-wsl-workspace README, the upstream source of the dsh-wsl-workspace DSH plugin. Copyright remains with the original authors.
Add a WSL workspace from the DeepSeek Harness web GUI and run the whole agent session — bash commands and file reads/writes — inside a local WSL distribution with Linux paths. Nothing needs to be installed inside WSL. The session can reach both WSL and Windows at the same time: bash commands run inside the WSL distribution, while Windows files stay accessible via `/mnt/<drive>` (for example `/mnt/c/Users/...`). ## Install Pick one of the three ways below, then restart `dsh web`: ```powershell # 1) npm package dsh plugin --profile web add dsh-wsl-workspace # 2) GitHub repository (ships the prebuilt lib/, no local build required) dsh plugin --profile web add https://github.com/6Mikao9/dsh-wsl-workspace # 3) Local directory (development / self-hosted) dsh plugin --profile web add D:\path\to\dsh-wsl-workspace ``` After restarting `dsh web`, a W button appears beside Settings at the sidebar foot. ## Usage Click the W button beside Settings at the sidebar foot to open the "Add WSL workspace" dialog. Pick a distribution from the list, then browse the directory tree or type an absolute Linux path (for example `/home/me/proj`) — use the Check button to verify the path exists before
Read the full READMERepository license: MIT
dsh-wsl-workspace DSH plugin questions
How do I install dsh-wsl-workspace?
You can install it via the DSH plugin system. Run `dsh plugin --profile web add dsh-wsl-workspace` in your terminal. Alternatively, you can add it from the GitHub repository or a local directory. After installation, restart `dsh web` to see the W button in the sidebar.
Do I need to install anything inside WSL?
No, nothing needs to be installed inside WSL. The plugin works by communicating with WSL through the Windows side. It uses the built-in WSL capabilities to run bash commands and access files.
How do I select a WSL distribution?
Click the W button next to Settings at the sidebar foot to open the "Add WSL workspace" dialog. From there, you can pick a distribution from the list. You can also browse the directory tree or type an absolute Linux path. Use the Check button to verify the path exists before creating the workspace.
Can I use a different user inside WSL for the bash tool?
Yes, in the "Add WSL workspace" dialog, there is an optional username field. If you leave it empty, the bash tool runs as the distribution's default user (often root). If you specify a Linux user name, the bash tool will run as that user (equivalent to `wsl.exe -u <username>`). The username only affects the bash tool, not the file tools.
Does the file tool respect DSH file policies?
Yes, the file tools (read/write/edit) go through the Windows-side WSL 9P share and are subject to the DSH file policy. Under `workspace-write` policy, reads work anywhere but writes are restricted to the session workspace. You can switch to `danger-full-access` to allow writes outside the workspace. The username field does not affect the file tools.