Skip to content
Back to search

wslmanager

GUI for the Windows Subsystem for Linux — and native Linux/macOS VMs on Mac. Install, back up, move and configure distros without CLI flags; AI assistant with tools, MCP server for agents, remote WSL over SSH.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bostrot/wslmanager with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bostrot/wslmanager'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bostrot--wslmanager/badge.svg)](/listings/bostrot--wslmanager)

HTML

<a href="/listings/bostrot--wslmanager"><img src="/api/listings/bostrot--wslmanager/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

<details> <summary>Microsoft Store</summary>

This app is available on the [Microsoft Store](https://apps.microsoft.com/store/detail/wsl-manager/9NWS9K95NMJB?hl=en-us&gl=US). </details>

<details> <summary>macOS via Homebrew</summary>

brew install --cask wsl-manager

Apple silicon, macOS 11 or newer. The cask ships with Homebrew itself, so no tap is needed; `brew upgrade --cask wsl-manager` picks up new releases. </details>

<details> <summary>Direct download</summary>

You can get this app with a direct download from the [Releases](https://github.com/bostrot/wslmanager/releases) page. Windows ships as a setup `.exe`, an `.msix` and a portable `.zip`; macOS as a `.dmg`. </details>

<details> <summary>Install via Winget</summary>

winget install Bostrot.WSLManager

</details>

<details> <summary>Install via Scoop</summary>

scoop install extras/wsl2-distro-manager

</details>

<details> <summary>Install via Chocolatey</summary>

This package is maintained by the community ([@mikeee](https://github.com/mikeee/ChocoPackages)). It is not an official package.

choco install wsl2-distro-manager

</details>

<details> <summary>Install a nightly build</summary>

The latest nightly build is available as an artifact in the "releaser" workflow or via [this link](https://nightly.link/bostrot/wslmanager/workflows/releaser/main/wsl2-distro-manager-nightly-archive.zip).

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 384 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">Welcome to WSL Manager 👋</h1>
  2. ![GitHub Release Date](https://img.shields.io/github/release-date/bostrot/wslmanager?style=for-the-badge)
  3. ![GitHub Workflow](https://img.shields.io/github/actions/workflow/status/bostrot/wslmanager/releaser.yml?branch=main&label=nightly&style=for-the-badge)
  4. ![GitHub release (latest by date)](https://img.shields.io/github/v/release/bostrot/wslmanager?style=for-the-badge)
  5. [![Documentation](https://img.shields.io/badge/DOCUMENTATION-WIKI-green?style=for-the-badge)](https://github.com/bostrot/wslmanager/wiki)
  6. [![GitLab stars](https://img.shields.io/gitlab/stars/bostrot/wsl2-distro-manager?gitlab_url=https%3A%2F%2Fgitlab.com&label=GitLab&style=for-the-badge)](https://gitlab.com/bostrot/wsl2-distro-manager)
  7. [![Discord](https://img.shields.io/discord/1100070299308937287?style=for-the-badge)](https://discord.gg/fY5uE5WRTP)
  8. <p align='center'>
  9. English | <a href='./readme/README_zh.md'>简体中文</a> | <a href='./readme/README_zh_tw.md'>繁體中文</a> | <a href='./readme/README_de.md'>Deutsch</a> | <a href='./readme/README_es.md'>Español</a> | <a href='./readme/README_ja.md'>日本語</a> | <a href='./readme/README_hu.md'>Magyar</a> | <a href='./readme/README_pt.md'>Português</a> | <a href='./readme/README_tr.md'>Türkçe</a>
  10. </p>
  11. ![WSL Distro Manager on Windows, dark theme](./readme/images/home-dark.png)
  12. <p align='center'>
  13. <sub>Shown on <b>Windows</b> &middot; the same app runs native VMs on <b>macOS</b> &mdash; expand <b>See it on macOS</b> below</sub>
  14. </p>
  15. <details>
  16. <summary>Preview with light theme (Windows)</summary>
  17. ![WSL Distro Manager on Windows, light theme](./readme/images/home-light.png)
  18. </details>
  19. <details>
  20. <summary><b>🍎 See it on macOS</b> &mdash; native Linux and macOS virtual machines through Apple's Virtualization framework <i>(beta)</i></summary>
  21. ![WSL Manager on macOS, dark theme](./readme/images/home-macos-dark.png)
  22. ![WSL Manager on macOS, light theme, with the AI assistant open](./readme/images/home-macos-light.png)
  23. </details>
  24. > **WSL Distro Manager** is a free, open source GUI for the Windows Subsystem
  25. > for Linux — and, on macOS, for native Linux VMs. Install, copy, rename,
  26. > move, back up and delete WSL distros without memorising a single `wsl.exe`
  27. > flag — plus templates, saved command snippets, disk mounting, `.wslconfig`
  28. > editing, remote WSL over SSH, and an MCP server that lets AI agents drive
  29. > your WSL environment. On a Mac the very same app manages virtual machines
  30. > through Apple's Virtualization framework instead.
  31. ## 🚀 Features
  32. **Manage distros**
  33. - [x] Install from a built-in catalogue, or bring your own rootfs
  34. - [x] Copy, rename, move to another drive, back up and delete instances
  35. - [x] Back every instance up to one folder — with a list of what is in it — and restore them all on another PC
  36. - [x] Compact virtual disks to reclaim space WSL never gives back
  37. - [x] Watch what an instance is using right now — processor time, memory and swap, with a live graph
  38. - [x] Supports Ubuntu, Debian, Alpine, Kali Linux, openSUSE, SLES and anything else WSL accepts
  39. **Get instances running faster**
  40. - [x] Use any Docker image as a distro — Docker itself is not required
  41. - [x] Package a configured distro as a portable `.wsl` file that installs on any machine (templates are deprecated in favour of these)
  42. - [x] Turnkey Linux and other LXC containers (experimental)
  43. - [x] Snippets: keep your setup commands in the app and run them on any instance
  44. - [x] Point the app at your own repository of rootfs images
  45. - [x] Browse a distro's files and copy the ones you pick into another instance — no share, no mount, no Explorer needed
  46. <!-- Unreleased. Containers, Kubernetes and Cloud are built but ship only in
  47. debug runs (LicenseManager.unreleasedFeaturesVisible, the gate Pro rides
  48. in a debug build); a release has none of them, so the README must not
  49. promise them. Lift the comment together with the gate.
  50. **Docker, Podman and WSL containers**
  51. - [x] See every container on the machine — every engine at once — next to your instances
  52. - [x] Create a container from an image, then start, stop, restart, remove and tail its logs without leaving the app
  53. - [x] Front end only: it drives the `docker`, `podman` or built-in `wslc` you already have, and installs nothing
  54. - [x] The AI chat and the MCP server get the same container tools
  55. **Kubernetes clusters**
  56. - [x] Every cluster in your kubeconfig, one namespace at a time — built for ten clusters of a hundred apps
  57. - [x] Deployments, StatefulSets and DaemonSets with health at a glance, filtered by name, namespace or image
  58. - [x] Open a workload to see its pods, tail their logs, restart a pod, roll out a restart, scale, or read the full details
  59. - [x] Front end only: it drives the `kubectl` you already have, and never rewrites your kubeconfig or switches your context
  60. - [x] The AI chat and the MCP server can read your clusters too — workloads, pods, events, resource usage and searchable pod logs — and only read them: nothing there can restart, scale or delete anything
  61. **Deploy to the cloud** *(beta)*
  62. - [x] Push a whole instance to a brand-new Hetzner Cloud server in one step — the root filesystem is exported, uploaded and started there as a container
  63. - [x] The server is created for you: size, location and base image, with cloud-init installing Docker and your own SSH key authorized for `root`
  64. - [x] Works from macOS too: a Linux VM's root filesystem is read out of the running guest, since its disk image is a bootable machine rather than something a container engine can read
  65. - [x] Pull it back down again as a new local instance whenever you want, leaving the server running — on macOS that restores into a copy of the VM it was deployed from, which has to still exist and be stopped, because a bare root filesystem has no kernel to boot
  66. - [x] See what each server costs per month, power them on and off, and delete them from the same list
  67. -->
  68. **Configure without editing files by hand**
  69. - [x] systemd, automount, default user, start command and start path per distro
  70. - [x] Memory, processors, swap, networking mode, DNS and the rest of `.wslconfig`
  71. - [x] Mount a physical disk or a VHD into WSL, with partition and filesystem control
  72. - [x] Share host folders into a distro or VM at a mount point you pick, read-only if you like — the AI Workspace included
  73. **Work the way you already do**
  74. - [x] Open Windows Terminal, VS Code or Explorer straight inside a distro
  75. - [x] Every instance in the Windows Terminal dropdown, kept current while the app runs — contributed as a fragment of its own, so your Terminal settings are never edited
  76. - [x] Manage WSL on a *different* Windows machine over SSH
  77. - [x] Sync a distro between two machines on your network
  78. - [x] Reach an instance by name: its hostname is kept in your hosts file, so `ssh ubuntu.wsl` keeps working after a reboot
  79. - [x] Keeps itself up to date: the website and GitHub builds download and install new releases themselves (Store installs are updated by the Store)
  80. - [x] Dark and light themes, available in nine languages
  81. **On macOS: native virtual machines** *(beta)*
  82. - [x] The same app manages VMs through Apple's Virtualization framework instead of WSL
  83. - [x] Create Linux VMs from an installer ISO, a cloud image or an exported template
  84. - [x] Create macOS guest VMs from a restore image (Apple Silicon)
  85. - [x] Start, stop, clone, export/import and template VMs like distros
  86. - [x] Run commands inside VMs over auto-provisioned SSH (cloud-init), from the GUI, the AI chat or MCP clients
  87. - [x] A terminal on any VM from its row: an SSH session on a Linux or macOS guest, the serial console where Linux has nothing to SSH to
  88. - [x] Your own `~/.ssh` key is authorized in every Linux VM (and created if you have none), so plain `ssh user@vm-ip` works too
  89. - [x] Every VM gets a login password you can read back from its row, for signing in at the VM's own screen
  90. - [x] Set the account every SSH path signs in as from the same row — a macOS guest's name is typed into Setup Assistant, where the app cannot see it
  91. - [x] Build with `scripts/build_macos.sh` — bundles the signed `vmctl` helper
  92. **Pro** *(one-time purchase: a licence key from [wslmanager.com/buy](https://wslmanager.com/buy/), on Windows and macOS alike — never a subscription)*
  93. - [x] **AI Workspace** — run Hermes Agent, OpenClaw, Open WebUI and OpenCode in a dedicated, isolated WSL distro
  94. - [x] **One model and endpoint for every AI tool** — the assistant's API endpoint, key and model from Settings are what OpenCode, OpenClaw and Hermes use too; set them once, and a tool installed later gets them as well
  95. - [x] **AI assistant with tools** — the built-in chat can actually *operate* your WSL: it lists and inspects distros, runs commands, edits config, creates snippets, mounts disks and packages distros through the same tools the MCP server exposes
  96. - [x] **Every AI run that changes an instance is saved as a snippet** — the commands it ran and what each tool reported, linked from the chat, so you can review it, run it again on a fresh instance or share it
  97. - [x] **Sandboxed AI** — spin up a throwaway Ubuntu distro and give an AI chat access to *only* the inside of that sandbox
  98. - [x] **Task queue** — hand the assistant a checklist and let it work through it, ticking items off as it goes
  99. - [x] **MCP server** — expose WSL to Claude Desktop, Claude Code, opencode and other MCP clients
  100. - [x] **Web dashboard** — manage everything from your phone or another computer: scan a QR code, get the whole app in a browser, optionally published beyond your network through a Cloudflare tunnel
  101. > The AI features run on credentials **you** bring — your own OpenAI-compatible
  102. > API key. No AI service is hosted or included, there is no quota, and no
  103. > requests pass through anyone else's servers. Pro unlocks the features in the
  104. > app; it does not buy AI credits. See [Free vs Pro](https://github.com/bostrot/wslmanager/wiki/Pro-Version).
  105. > **Why is there a paid tier at all?** WSL Manager has been a one-person,
  106. > spare-time project since 2021, and every feature above — the free ones
  107. > included — was built in evenings and weekends. Managing your distros and VMs
  108. > is free and stays free, and the whole app stays open source. Pro is the AI
  109. > layer on top, and what it earns is what lets maintenance and new features
  110. > become planned, regular work instead of whatever time is left over. Buy it
  111. > once, keep it forever, and you are directly funding the next release.
  112. ## 🤖 AI assistant & MCP *(Pro)*
  113. Everything in this section is part of **Pro**; the free app has none of it.
  114. The AI assistant is an **agent**, not just a chat box: it is given the same tool
  115. set the MCP server exposes, so when you ask "what distros do I have?" or "install
  116. Ubuntu and set my default user" it calls real tools against your WSL rather than
  117. guessing. Tool calls are shown inline as it works.
  118. **Set up the provider** in **Settings → Bring Your Own AI Key**: any
  119. OpenAI-compatible endpoint works (OpenAI, Azure, a LiteLLM proxy, Ollama, LM
  120. Studio, …). Enter the base URL, key and model. The **Load model list** button
  121. fills an autocomplete from the provider's `/models`, and **Test connection**
  122. proves the credentials work before you open the chat.
  123. **Don't want any of it?** **Settings → Bring Your Own AI Key → AI features** switches the assistant, the error diagnosis and the AI Workspace off — nothing AI-related is shown, and no workspace environment is set up for you. It is off until you answer: WSL Manager asks once, on the first start after installing or updating, and nothing AI-related runs before that.
  124. **Sandboxes** (AI Workspace → *Add sandbox distro*) create a throwaway
  125. instance from any catalog image (newest Ubuntu by default) — a WSL distro on
  126. Windows, a Linux VM seeded from a cloud image on macOS, which is created and
  127. booted for you. Its chat is handed only the `sandbox_*` tools, which are locked
  128. to that one instance — the model can run anything *inside* the sandbox and can
  129. never see your host or any other instance. One honest caveat: the sandbox
  130. itself has normal outbound internet access, like any distro or VM. Sandbox chats use the same docked panel
  131. as the assistant (task queue included), their transcripts persist, and the
  132. history button in the chat header switches between the assistant and any
  133. sandbox session.
  134. **Task queue** — open the *Tasks* section at the top of the chat, add items, and
  135. press ▶. The assistant works through them with its tools and checks each off as
  136. it finishes; you can keep adding tasks while it runs.
  137. ### Connecting external AI clients (MCP)
  138. Turn on **Settings → MCP Server** (Pro). It serves the MCP protocol at
  139. `http://127.0.0.1:59133/mcp`, loopback-only, guarded by a bearer token shown in
  140. the same panel. The tools cover the full lifecycle — create, import, configure,
  141. run, package and (with a confirm flag) unregister distros, plus snippets, disk
  142. mounting and persistent terminal sessions.
  143. **Claude Desktop** — click **Connect Claude Desktop** in the MCP panel. It writes
  144. the entry below into `claude_desktop_config.json` for you (needs Node.js);
  145. restart Claude Desktop afterwards. To do it by hand, or for any other stdio MCP
  146. client, bridge the HTTP endpoint with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):
  147. ```jsonc
  148. // claude_desktop_config.json (%APPDATA%\Claude\)
  149. {
  150. "mcpServers": {
  151. "wsl-manager": {
  152. "command": "npx",
  153. "args": [
  154. "-y", "mcp-remote",
  155. "http://127.0.0.1:59133/mcp",
  156. "--header", "Authorization:${AUTH_HEADER}"
  157. ],
  158. "env": { "AUTH_HEADER": "Bearer <TOKEN FROM THE MCP PANEL>" }
  159. }
  160. }
  161. }
  162. ```
  163. **Claude Code** — same bridge, one command:
  164. ```bash
  165. claude mcp add wsl-manager -- npx -y mcp-remote http://127.0.0.1:59133/mcp \
  166. --header "Authorization: Bearer <TOKEN>"
  167. ```
  168. **opencode** — add it under `mcp` in your `opencode.json` (or `~/.config/opencode/opencode.json`):
  169. ```jsonc
  170. {
  171. "mcp": {
  172. "wsl-manager": {
  173. "type": "local",
  174. "command": ["npx", "-y", "mcp-remote", "http://127.0.0.1:59133/mcp",
  175. "--header", "Authorization: Bearer <TOKEN>"]
  176. }
  177. }
  178. }
  179. ```
  180. Any MCP client that speaks streamable HTTP can also point straight at the
  181. endpoint with an `Authorization: Bearer <TOKEN>` header, skipping `mcp-remote`.
  182. To reach it from another machine, enable the built-in **Cloudflare tunnel**
  183. toggle in the same panel and use the public URL it prints.
  184. ## 📱 Web dashboard *(Pro)*
  185. Turn on **Settings → Web Dashboard** (Pro) and the app serves a browser
  186. dashboard on port `59134` for every device on your network — Windows and macOS
  187. alike. Scan the QR code the panel shows with your phone (or copy the link) and
  188. you get the whole app in a browser: start, stop, duplicate and delete instances,
  189. run commands, open persistent terminal sessions, run your saved snippets, and
  190. drive every other tool (import, export, packaging, `.wslconfig`, disks, VM
  191. creation) through generated forms. It is the same tool set the AI assistant
  192. and the MCP server use.
  193. Access is guarded by a token that is part of the link (`?token=…`), so a
  194. scanned QR code is all a device needs — and regenerating the token in the
  195. panel revokes every link handed out so far. The dashboard binds to all
  196. interfaces on purpose; flip **Publish via Cloudflare Tunnel** in the same panel
  197. to get a temporary public HTTPS link (the QR code switches to it) when you need
  198. it away from home. Once published, the token is the only thing protecting a
  199. surface that can run commands, so share that link with care.
  200. ## 📦 Install
  201. <details>
  202. <summary>Microsoft Store</summary>
  203. This app is available on the [Microsoft Store](https://apps.microsoft.com/store/detail/wsl-manager/9NWS9K95NMJB?hl=en-us&gl=US).
  204. </details>
  205. <details>
  206. <summary>macOS via Homebrew</summary>
  207. ```sh
  208. brew install --cask wsl-manager
  209. ```
  210. Apple silicon, macOS 11 or newer. The cask ships with Homebrew itself, so no tap is needed; `brew upgrade --cask wsl-manager` picks up new releases.
  211. </details>
  212. <details>
  213. <summary>Direct download</summary>
  214. You can get this app with a direct download from the [Releases](https://github.com/bostrot/wslmanager/releases) page. Windows ships as a setup `.exe`, an `.msix` and a portable `.zip`; macOS as a `.dmg`.
  215. </details>
  216. <details>
  217. <summary>Install via Winget</summary>
  218. ```sh
  219. winget install Bostrot.WSLManager
  220. ```
  221. </details>
  222. <details>
  223. <summary>Install via Scoop</summary>
  224. ```sh
  225. scoop install extras/wsl2-distro-manager
  226. ```
  227. </details>
  228. <details>
  229. <summary>Install via Chocolatey</summary>
  230. This package is maintained by the community ([@mikeee](https://github.com/mikeee/ChocoPackages)). It is not an official package.
  231. ```sh
  232. choco install wsl2-distro-manager
  233. ```
  234. </details>
  235. <details>
  236. <summary>Install a nightly build</summary>
  237. The latest nightly build is available as an artifact in the "releaser" workflow or via [this link](https://nightly.link/bostrot/wslmanager/workflows/releaser/main/wsl2-distro-manager-nightly-archive.zip).
  238. </details>
  239. ## ⚙️ Build
  240. Make sure [flutter](https://flutter.dev/desktop) is installed.
  241. ### Windows
  242. ```powershell
  243. flutter config --enable-windows-desktop
  244. flutter upgrade
  245. flutter build windows # build it
  246. flutter run -d windows # run it
  247. ```
  248. ### macOS
  249. VMs are created by `vmctl`, a small Swift helper that drives
  250. Virtualization.framework — not by the Flutter app itself. The framework only
  251. answers processes carrying the `com.apple.security.virtualization` entitlement,
  252. and `swift build` does not add it, so **the helper must be built and signed
  253. before the app can start a VM**:
  254. ```bash
  255. flutter config --enable-macos-desktop
  256. # Build + sign vmctl and install it for dev runs. Re-run after any change
  257. # under macos/vmctl/ — `flutter run` never rebuilds the helper.
  258. VMCTL_ONLY=1 scripts/build_macos.sh
  259. flutter run -d macos
  260. ```
  261. Skip that step and the app launches fine, but starting a VM fails with:
  262. ```
  263. VM failed to start: Error Domain=VZErrorDomain Code=2 "The process doesn't
  264. have the "com.apple.security.virtualization" entitlement."
  265. ```
  266. That is the *helper* missing the entitlement, not the app — `Runner`'s own
  267. entitlements are already correct. The signed helper is installed to
  268. `~/Library/Application Support/WSLManager/bin/vmctl`, which is where debug runs
  269. look for it; without it they fall back to the unsigned `swift build` output
  270. under `macos/vmctl/.build/`, which is what produces the error above.
  271. `scripts/build_macos.sh` without `VMCTL_ONLY` does the same signing and then
  272. builds the release app, bundling the signed helper into the bundle's
  273. `Contents/Resources/`. Building the app itself needs full Xcode.
  274. ## Author
  275. 👤 **Eric Trenkel**
  276. - Website: [erictrenkel.com](https://erictrenkel.com)
  277. - GitHub: [@bostrot](https://github.com/bostrot)
  278. - LinkedIn: [@erictrenkel](https://linkedin.com/in/erictrenkel)
  279. 👥 **Contributors**
  280. [![Contributors](https://contrib.rocks/image?repo=bostrot/wslmanager)](https://github.com/bostrot/wslmanager/graphs/contributors)
  281. ## 🤝 Contributing
  282. Contributions, issues and feature requests are welcome!\
  283. Feel free to check the [issues page](https://github.com/bostrot/wslmanager/issues).
  284. You can also take a look at the [contributing guide](https://github.com/bostrot/wslmanager/blob/main/CONTRIBUTING.md).
  285. ## Show your support
  286. Give a ⭐️ if this project helped you!
  287. ## 📝 License
  288. Copyright © 2026 [Eric Trenkel](https://github.com/bostrot).\
  289. This project is [GPL-3.0](https://github.com/bostrot/wslmanager/blob/main/LICENSE) licensed.
  290. ---
  291. _Not found what you were looking for? Check out the [Wiki](https://github.com/bostrot/wslmanager/wiki)_

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.