dsh-wsl

When building AI agents on Windows that need Linux capabilities, developers have typically resorted to hand-written .sh scripts or PowerShell wrappers around wsl.exe — a brittle approach plagued by quoting edge cases, variable-expansion surprises, and path-format mismatches. dsh-wsl removes that middle layer entirely, exposing three clean model-facing tool interfaces so an agent can invoke Linux operations with simple parameters and no separate script maintenance.

The plugin registers three core tools: wsl executes any Linux command and returns stdout/stderr annotated with [exit code], [killed by signal], and [output truncated] markers; wsl-path converts between Windows drive paths and WSL Unix paths in either direction, auto-detected or explicitly forced; wsl-env summarises the active distributions, kernel version, CPU count, memory, and disk usage so an agent can reason about the environment before acting. Built-in safeguards include a destructive-command guard, automatic rewriting of Windows paths to /mnt/ prefixes, reliable environment-variable passthrough, and capped output with disk-spilling for large streams.

It is aimed at DSH developers working on Windows who want their agents to run Linux commands, inspect system resources, perform deployment or debugging tasks, and do all of it without maintaining a parallel script layer or shell wrapper.