wsl-bridge
DSH (DeepSeek Harness) Cordis plugin that lets an agent running inside WSL
(Windows Subsystem for Linux) access and invoke Windows-side files and
programs.
Built for agents that live in WSL but need the Windows host: read/write files
on C:\, run .exe programs, open things in Explorer, list drives, convert
paths.
Tools
| Tool | Purpose |
|---|
win_ls | List a Windows directory (accepts C:\... or /mnt/c/...) |
win_read | Read a Windows text file (utf8/gbk, line offset/limit) |
win_write | Write UTF-8 text to a Windows file (creates parent dirs) |
win_run | Run a Windows program (cmd / powershell / direct interop) |
win_open | Open a file/folder with the default Windows handler |
win_path | Convert between C:\... and /mnt/c/... (wslpath) |
win_drives | List mounted Windows drives |
Optional (when codebase-memory-mcp is installed):
codebase_search, codebase_arch — knowledge-graph code search.
How it works
Everything runs through the host shell service (the same seam the built-in
bash tool uses) with the calling session's sandbox policy applied per call.
Path normalization handles both C:\Users\me and /mnt/c/Users/me forms.
win_run writes temp .bat/.ps1 files to C:\Windows\Temp and cleans up
after itself; PowerShell output is forced to UTF-8 console encoding.
Install (DSH bundle)
Standard DSH bundle — install with the official plugin command (auto-inits
the profile, pnpm-installs, and appends the bundle layer per
dsh.bundle.patch):
dsh plugin --profile web add /path/to/dsh-wsl-bridge
# or: dsh plugin --profile web add github:you/dsh-wsl-bridge
# Restart dsh web; the tools mount automatically.
Dependencies are declared as peerDependencies (ecosystem convention —
@deepseek-ai/dsh-tools is already loaded in the DSH process). Optional env
vars at apply time: CODEBASE_MEMORY_BIN for the codebase-memory tools
(default /usr/local/bin/codebase-memory-mcp; they error if absent).
Requirements
- WSL with Windows interop enabled (
cmd.exe, powershell.exe, wslpath,
explorer.exe reachable — standard on WSL1/WSL2)
- DSH host with the
shell and sandboxPolicy services
License
MIT
