dsh-wsl

When your dsh agent needs to run Linux commands on a Windows machine, WSL is the most natural bridge—but without a native binding layer, every step is awkward: hand-assembling wsl flags, writing /mnt/c path mappings by hand, and dealing with UTF-16LE output that suddenly appears in the pipeline. dsh-wsl collapses all of that into five native tools: wsl_run for command execution, wsl_distro_list for distro inspection, wsl_status for state and warnings, wsl_path_convert for bidirectional path translation, and wsl_copy for cross-system file transfer, so the agent never has to worry about low-level parameter construction.

The plugin's most underappreciated value is automatic encoding normalization: WSL pipe output is UTF-16LE while dsh agents expect UTF-8, and dsh-wsl handles that conversion transparently, with a dual-decode fallback for mixed encodings such as Chinese error messages in UTF-8 alongside UTF-16 body text. It also ships with a defaultDistro setting, a configurable timeoutMs, and honest error reporting when common environmental issues such as disabled virtualization cause WSL2 to fail—no silent failures.

It is built for developers on Windows 10/11 who treat WSL2 as their daily Linux workspace and already rely on dsh agents. If you want your agent to run scripts, inspect distros, or shuttle files between the Windows and Linux side without you dropping into a terminal to type wsl --exec by hand, this is the plugin that makes a single tool call do the job.