wsl-utils provides JavaScript utilities for working with Windows Subsystem for Linux (WSL). It helps detect whether you are running in WSL, convert between WSL Linux paths and Windows paths, and determine Windows integration support like PowerShell accessibility and the default browser.
Project status
- Actively maintained, with very recent upstream activity (last push 2026-09-30) and a corresponding update (v1.0.1 on 2026-09-30).
- Update cadence looks active in 2026, with updates in January (v0.4.0), early January (v0.3.1), mid-November (v0.3.0, plus Node 20 engine bump), August (v1.0.0), and late September (v1.0.1).
AI summary generated
Recent updates
v1.0.1
v1.0.1 fixes path conversion edge cases in wsl-utils, specifically for WSL paths that begin with a dash and for array inputs to the path conversion helpers. The implementation now converts paths one-by-one via wslpath and adds a guard to prevent wslpath from misinterpreting leading dashes as options.
v1.0.0
v1.0.0 primarily addresses a failure mode in wslDefaultBrowser() when the current working directory inside WSL is not reachable from Windows. The fix ensures the spawned PowerShell process uses a safe working directory so URL association resolution works reliably.
v0.4.0
v0.4.0 adds new path conversion and classification helpers, including Windows-to-WSL conversion, UNC detection, and a filesystem mapper (WSL path to Windows filesystem vs WSL filesystem). It also extends `convertWslPathToWindows` to accept an array of paths (batch conversion).
Featuresv0.3.1
v0.3.1 focuses on improving how wsl-utils parses the `root` mount point from `wsl.conf`. The code changes replace a regex-based approach with a dedicated parser intended to properly handle inline comments and quoted values.
v0.3.0
v0.3.0 adds two new exported helpers, canAccessPowerShell() and wslDefaultBrowser(), intended for Windows integration scenarios in or near WSL. It also bumps the minimum supported Node.js version to 20. The implementation changes include a refactor of the existing powerShellPath export to delegate non-WSL behavior to powershell-utils.
BreakingFeaturesv0.2.0
Release v0.2.0 adds a new utility, `convertWslPathToWindows()`, intended to translate WSL Linux paths into Windows-accessible paths. The codebase also updates TypeScript typings and the README to document the new API.
Featuresv0.1.0
Release v0.1.0 was published on 2025-05-23, but the provided release notes contain no actionable information beyond a single emoji. No changes, features, fixes, breaking changes, or migration details are described, so there is not enough documentation here to assess upgrade impact.