Back to Explore

sindresorhus/wsl-utils

GitHub
1 updates · last 90 days2 watchersOpen source

Last release:

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. The upstream push and latest published update are very recent (2026-08-13, against today 2026-08-20), and there have been multiple updates in 2025-2026.
  • Apparent update cadence is moderately frequent, with updates spaced about 4 to 6 months in 2026 (Jan 25 to Aug 13), plus earlier quick follow-ups in January 2026 (Jan 2 to Jan 25), suggesting active iteration.

AI summary generated

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • 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).

    Features

  • v0.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.

    BreakingFeatures

  • v0.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.

    Features

  • v0.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.