A modern desktop application for managing Windows Subsystem for Linux (WSL) distributions.
- List & Monitor — View all WSL distributions with real-time status (Running / Stopped), disk usage, and creation date.
- Start / Stop — Start or terminate distributions with a single click.
- Clone — Duplicate an existing distribution via zero-copy pipe (export → import).
- Import / Export — Import from
.tar,.tar.gz, or.vhdxfiles; export to.tar. - Open Terminal — Launch Windows Terminal (or fallback to cmd) directly into the distribution.
- Open in VS Code — Open the WSL workspace in Visual Studio Code via Remote-WSL.
- Open File Explorer — Browse the WSL filesystem in Windows Explorer.
- Hide / Unhide — Hide distributions you don't need; toggle visibility at any time.
- i18n — Full internationalization support with Chinese and English.
Screenshots coming soon.
- Windows 10/11 with WSL enabled
- Node.js >= 18
- npm >= 9
Download the latest portable .exe from the Releases page.
# Clone the repository
git clone https://github.com/modiao2018/WSL-Manager.git
cd WSL-Manager
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build production
npm run build
# Package portable exe
npm run dist| Layer | Technology |
|---|---|
| Framework | Electron 41 |
| Frontend | React 19 + TypeScript |
| UI Library | Ant Design 6 |
| Build Tool | electron-vite + Vite |
| i18n | react-i18next |
src/
├── main/ # Electron main process
│ ├── index.ts # Window creation & app lifecycle
│ └── wsl-service.ts # WSL command wrapper & IPC handlers
├── preload/ # Preload script (contextBridge)
│ └── index.ts
└── renderer/ # React frontend
└── src/
├── components/ # UI components
├── hooks/ # Custom React hooks
├── i18n/ # Internationalization
├── App.tsx # Root component
└── types.ts # TypeScript type definitions
Contributions are welcome! Feel free to open an issue or submit a pull request.
This project is licensed under the MIT License.