List installed WSL distributions with their state and version, and mark the default.

Get WSL system info (OS, kernel, uptime, memory, disk, user) for a distro.

Health check: confirm a WSL distro is reachable and the persistent shell responds.

Translate a WSL POSIX path to a Windows UNC path, or vice versa. Useful for understanding where a WSL file lives on the Windows side.

Resolve a possibly-relative WSL POSIX path (handles ~, ., ..) to an absolute POSIX path, using a working directory and the distro home.

Read a file from WSL. Text files return UTF-8 content; binary files return base64 with a mimeType. Supports offset/limit for large files; sha256=true returns a hash of the read bytes for round-trip verification.

Read multiple files from WSL in one call (reduces round-trips). Each entry is returned independently; failures do not abort the batch.

Write a file in WSL. content is UTF-8 text by default; set encoding="base64" for binary content. Creates parent directories as needed. sha256=true returns a hash of the written bytes for round-trip verification.

Line/substring-based edit of a WSL file: replace oldString with newString. oldString must be unique unless replaceAll=true. Use dryRun=true to preview.

List entries in a WSL directory, with type and size. Directories sort first. Supports offset/limit pagination for large directories.

Stat a WSL path: type, size, mode, mtime, atime.

Create a directory in WSL (recursive).

Move or rename a file/directory within WSL.

Delete a file or directory in WSL. Recursive directory deletion requires recursive=true and may require confirm=true for shallow paths (guardrail).

Run a shell command in WSL (foreground, waits for completion). Supports multi-line scripts, cwd, env vars, and timeout. Returns stdout (and stderr, separately when separateStderr=true; otherwise stderr is merged into stdout) and exit code. Dangerous commands are blocked by the guardrail (confirm=true overrides confirmable ones).

Set the persistent shell working directory for a distro. Subsequent run_command calls without an explicit cwd will run here.

Start a long-running process in WSL (backgrounded). Returns a handle and pid; output is streamed to a log file readable via read_process_output.

Check whether a started process is still running, and its exit code if finished.

Read new output from a started process log, incrementally by byte offset. Pass follow=true to briefly wait for new output; stream=true to additionally push each new chunk as a notifications/message (and notifications/progress when the client sent a progressToken) as it arrives. which selects stdout (default) or stderr. Returns the next offset to use.

List all processes started via start_process that this server is tracking.

Send a signal to a started process (default SIGTERM). Use signal=KILL to force. Uppercase signal names only.

Find files in WSL by name pattern (find -name). Returns matching POSIX paths.

Search file contents in WSL (recursive grep). Returns file:line:match entries. Uses ripgrep if available, else falls back to grep.

List TCP ports listening in WSL (via ss, falling back to /proc/net/tcp). Useful to find where a dev server is reachable (WSL2 forwards localhost to Windows).

Read environment variables from the persistent WSL shell. Pass name for one var, or omit for all.

Set an environment variable in the persistent WSL shell (persists across run_command calls).

Run a diagnostic sweep: distros, UNC reachability, persistent shell, /tmp/wsl-bridge, and a UNC write/read probe. Returns a pass/fail report.

Query the audit log of past tool calls (most-recent-first). Filter by tool, since (ISO timestamp), or keyword.