Tools & Capabilities

dsh-wsl-bridge

ch1bug/dsh-wsl-bridge · ★ 2

ch1bug

DSH (DeepSeek Harness) Cordis plugin that lets an agent running inside WSL (Windows Subsystem for Linux) access and invoke Windows-side files and programs .

Archived repository

License
MIT
Added
2026-08-23
Maintenance
archived
Install kind
github

No manifest check is available; listing does not imply compatibility or security review.

安装

dsh plugin --profile web add github:ch1bug/dsh-wsl-bridge

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents
  1. Tools
  2. How it works
  3. Install (DSH bundle)
  4. Requirements
  5. License

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