dbfx · gvtret · Jun 26, 2026 · Jun 26, 2026 · Jul 3, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -60,6 +60,9 @@ Tests
   ├── tests/cli.test.js              # Tests for CLI parseArgs, stripHtml, formatBytes
   ├── tests/i18n.test.js             # Tests for renderer/i18n.js (t, tp, tError)
   ├── tests/wsl-ops-distro.test.js   # Tests for distro management exports and signatures
+  ├── tests/wsl-compat.test.js       # Backward compat: WSL without version/wslc
+  ├── tests/wsl-config.test.js       # .wslconfig INI section handling
+  ├── tests/wsl-host.test.js         # WSL version parsing and wslc JSON
   └── tests/migrate.test.js          # Tests for distro migration functions
 ```
 

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,17 @@
+# [1.9.0](https://github.com/dbfx/wsl-cleaner/compare/v1.8.0...v1.9.0) (2026-07-03)
+
+
+### Features
+
+* WSL 2.9.3 support: WSL Containers (`wslc`) prune task, health dashboard card, host tool detection
+* Config Editor: write experimental keys to `[experimental]` section; add Consomme networking mode
+* Show installed WSL version in status bar and Health dashboard
+
+### Fixes
+
+* `vscode-old-bins` cleanup command (no awk quoting errors through `bash -lc`)
+* `git-gc` skip empty repository paths in log output
+
 # [1.8.0](https://github.com/dbfx/wsl-cleaner/compare/v1.7.1...v1.8.0) (2026-02-24)
 
 

diff --git a/README.md b/README.md
@@ -79,6 +79,7 @@ Full control over every cleanup task. Each task has a toggle, a description expl
 - Clean Android SDK & Gradle Build Cache
 - Clean Python Bytecode -- `__pycache__` directories
 - Clean Docker Dangling Artifacts -- removes only dangling images, unused networks, and stale build cache (all named images, containers, and volumes are preserved)
+- Clean WSL Containers Dangling Artifacts -- prunes unused WSLC images, containers, and volumes via native `wslc` (WSL 2.9+; no Docker Desktop required)
 - Clean Terraform Plugin Cache
 - Clean Minikube Cache
 - Compact Git Repositories -- finds all repos under `/home` and runs `git reflog expire --expire=now --all` + `git gc --prune=now --aggressive`
@@ -128,8 +129,8 @@ Real-time system health dashboard for your WSL distributions. Auto-refreshes eve
 - **Disk & I/O** -- filesystem usage bar, I/O pressure (some/full percentages)
 - **Networking** -- interface RX/TX stats table, listening ports table, DNS resolution status (green/red indicator with server address)
 - **Processes** -- top 20 by CPU, zombie process detection with count and PID table
-- **Services** -- Docker container counts (running/stopped), systemd state with failed unit listing (filters out known-harmless WSL failures)
-- **System info** -- installed package count, GPU/CUDA availability, WSL interop status
+- **Services** -- Docker and WSL Containers (`wslc`) counts (running/stopped), systemd state with failed unit listing (filters out known-harmless WSL failures)
+- **System info** -- installed WSL version, installed package count, GPU/CUDA availability, WSL interop status
 - **WSL config** -- reads `.wslconfig` memory/swap limits and displays alongside actual usage
 
 ### Distros
@@ -173,8 +174,8 @@ GUI editor for `.wslconfig` (global) and per-distro `wsl.conf` files with valida
 
 **`.wslconfig` tab** -- global WSL 2 settings applied to all distros:
 - Memory limit, processor count, swap size, swap file path
-- Networking mode (NAT / Mirrored), localhost forwarding, DNS tunneling, DNS proxy, auto proxy, firewall
-- Auto memory reclaim (disabled / gradual / drop cache), sparse VHD, page reporting
+- Networking mode (NAT / Mirrored / Consomme), localhost forwarding, DNS tunneling, DNS proxy, auto proxy, firewall
+- Experimental: auto memory reclaim (disabled / gradual / drop cache), sparse VHD
 - Nested virtualization, VM idle timeout, GUI applications (WSLg), debug console, kernel command line
 
 **`wsl.conf` tab** -- per-distro settings with distro selector:

diff --git a/cli.js b/cli.js
@@ -218,7 +218,7 @@ async function actionClean(opts) {
   const distro = resolveDistro(opts);
 
   if (!opts.json) info(`${c.bold}Detecting tools in ${distro}...${c.reset}`);
-  const tools = wslOps.detectTools(distro);
+  const tools = { ...wslOps.detectHostTools(), ...wslOps.detectTools(distro) };
 
   if (opts.verbose && !opts.json) {
     const available = Object.entries(tools).filter(([, v]) => v).map(([k]) => k);
@@ -234,6 +234,10 @@ async function actionClean(opts) {
     return true;
   });
 
+  const hostTasks = tasksToRun.filter(t => t.host);
+  const distroTasks = tasksToRun.filter(t => !t.host);
+  tasksToRun = [...hostTasks, ...distroTasks];
+
   // Validate --tasks IDs
   if (opts.tasks) {
     const allIds = new Set(TASKS.map(t => t.id));
@@ -291,13 +295,19 @@ async function actionClean(opts) {
       ? ({ text }) => process.stdout.write(`${c.dim}${text}${c.reset}`)
       : undefined;
 
-    const result = await wslOps.runCleanupTask({
-      distro,
-      taskId: task.id,
-      command: task.command,
-      asRoot: task.asRoot,
-      onOutput,
-    });
+    const result = task.host
+      ? await wslOps.runHostCleanupTask({
+        taskId: task.id,
+        command: task.command,
+        onOutput,
+      })
+      : await wslOps.runCleanupTask({
+        distro,
+        taskId: task.id,
+        command: task.command,
+        asRoot: task.asRoot,
+        onOutput,
+      });
 
     results.push({ id: task.id, name: label, ...result });
 

diff --git a/docs/MR-wsl-2.9.3-support.md b/docs/MR-wsl-2.9.3-support.md
@@ -0,0 +1,174 @@
+# MR: WSL 2.9.3 support & host containers cleanup (v1.9.0)
+
+**Branch:** `feat/wsl-2.9.3-support`  
+**Base:** `main` (или `security-hardening`, если MR идёт туда первым)  
+**Версия:** `1.9.0`
+
+---
+
+## Summary
+
+Добавляет поддержку **WSL 2.9.3** и **WSL Containers (`wslc`)**: очистка dangling-артефактов на хосте, карточка в Health Dashboard, отображение версии WSL. Исправляет Config Editor — experimental-ключи `.wslconfig` пишутся в `[experimental]`, а не в `[wsl2]` (устраняет предупреждения WSL об unknown keys). Включает регрессионные тесты для старых версий WSL без `wsl --version` и без `wslc`.
+
+Также в ветке (если ещё не в `main`): security-hardening для WSL-команд, live-output logging, VHDX через реестр Lxss, retry при `Wsl/Service/0x8007274c`, фиксы `vscode-old-bins` / `git-gc`.
+
+---
+
+## Контекст
+
+[WSL 2.9.3](https://github.com/microsoft/WSL/releases/tag/2.9.3) (pre-release) добавляет:
+
+- **WSL Containers (WSLC)** — нативный `wslc` CLI (аналог docker prune на хосте)
+- Режим сети **Consomme** (бывший VirtioProxy)
+- Улучшения memory reclaim, virtiofs, стабильности shutdown/migrate
+
+Пользователи **без** WSL 2.9 не должны заметить регрессий: новые фичи опциональны и отключаются через детект инструментов.
+
+---
+
+## Изменения
+
+### WSL Containers (`wslc`)
+
+| Компонент | Что сделано |
+|-----------|-------------|
+| `lib/wsl-ops.js` | `detectHostTools()`, `getWslHostInfo()`, `runHostCleanupTask()` с allowlist prune-команд |
+| `renderer/tasks.js` | Задача `wslc-prune` (`host: true`, `requires: 'wslc'`) |
+| `renderer/app.js` | Host-задачи выполняются один раз на хосте; merge host + distro tools |
+| `cli.js` | Host tools + host task execution |
+| Health UI | Карточка WSL Containers (running/stopped/total) |
+| Status bar | `WSL 2 Ready — N distro(s) — v2.9.3.0` при наличии `wsl --version` |
+
+### Config Editor (`.wslconfig`)
+
+- `autoMemoryReclaim`, `sparseVhd` → секция **`[experimental]`** (по [MS Learn](https://learn.microsoft.com/en-us/windows/wsl/wsl-config))
+- При загрузке читаются legacy-значения из `[wsl2]`
+- Удалён **`pageReporting`** (нет в актуальной документации, вызывал unknown key)
+- Добавлены режимы сети: **Consomme**, **VirtioProxy (legacy)**
+
+### Прочие фиксы задач
+
+- **`vscode-old-bins`** — `find -printf` + `cut` вместо `awk` (ошибка quoting через `bash -lc`)
+- **`git-gc`** — пропуск пустых путей в цикле `find`
+
+### Версионность и документация
+
+- `package.json` → **1.9.0**
+- `CHANGELOG.md` — секция 1.9.0
+- `README.md` — WSLC, Consomme, experimental-секция
+- `locales/en.json` — новые ключи (остальные языки: `npm run translate`)
+
+---
+
+## Обратная совместимость
+
+| Сценарий | Поведение |
+|----------|-----------|
+| Нет `wsl --version` (старый inbox WSL) | `checkWsl()` OK, `version: null`, UI без номера версии |
+| Нет `wslc` | `wslc-prune` скрыта/disabled; `runHostCleanupTask` skip с `ok: true` |
+| Legacy `.wslconfig` с experimental в `[wsl2]` | Читается; при Save — перенос в `[experimental]` |
+| Docker без daemon | `docker-prune` по-прежнему skip (exit 0) |
+
+Покрыто тестами: `tests/wsl-compat.test.js`, `tests/wsl-config.test.js`, `tests/wsl-host.test.js`.
+
+---
+
+## Тесты
+
+```bash
+npm test
+```
+
+**224 теста**, в т.ч.:
+
+- `wsl-compat.test.js` — старый WSL без version/wslc
+- `wsl-config.test.js` — секции INI
+- `wsl-host.test.js` — парсинг версий 2.0.x / 2.7.x / 2.9.x
+- `tasks.test.js` — регрессии команд задач
+- `security.test.js` — allowlist `runHostCleanupTask`
+
+---
+
+## Test plan (ручная проверка)
+
+### Уже проверено
+
+- [x] **Status bar**: `WSL 2 Ready — N distro(s) — v2.9.3.0`
+- [x] **Health → System Info**: WSL Version отображается (не `--`)
+- [x] **Health → WSL Containers**: карточка видна (0/0/0 — OK)
+- [x] **Health → авто-обновление**: версия не сбрасывается в `--` через ~15 с
+- [x] **Config → Experimental**: `sparseVhd` / `autoMemoryReclaim` в `[experimental]`
+- [x] **Config → Networking**: Consomme / VirtioProxy сохраняется
+- [x] **Legacy config**: experimental-ключи переезжают из `[wsl2]` в `[experimental]`
+- [x] **`vscode-old-bins`**: OK в Simple Clean (без ошибки awk)
+- [x] **`git-gc`**: OK — `Git compaction complete` в Live Output
+
+### Новое в 1.9.0
+
+| Что | Как проверить | Статус |
+|-----|----------------|--------|
+| **`wslc-prune`** | Settings → включить → Clean. В Live Output — prune на хосте, без падения | ⏳ после перезапуска GUI (fix `-f` → без флага) |
+| **Config → Experimental** | `sparseVhd` / `autoMemoryReclaim` → Save → `%UserProfile%\.wslconfig` → `[experimental]` | ✅ |
+| **Config → Networking** | Consomme / VirtioProxy → Save | ✅ |
+| **Legacy config** | Ключи из `[wsl2]` → `[experimental]` после Save | ✅ |
+
+### Остальное
+
+- [x] **Simple mode**: одна кнопка Clean завершается без ошибок (Clean & Compact ~10 мин, `WSL restarted` в логе)
+- [x] **Старая WSL / без wslc**: приложение стартует, Clean работает, `wslc-prune` недоступна (покрыто автотестами)
+- [x] **Config Editor**: Save + unknown keys — OK (ручная проверка)
+- [x] `npm run build` → `dist/WSL Cleaner Setup 1.9.0.exe`
+
+---
+
+## Файлы (основные)
+
+```
+lib/wsl-ops.js          # version, host tools, wslc stats, runHostCleanupTask
+main.js, preload.js     # IPC
+cli.js                  # CLI host tasks
+renderer/app.js         # UI, config sections, cleanup loop
+renderer/tasks.js       # wslc-prune, command fixes
+renderer/index.html     # Health wslc card, config options
+locales/en.json         # i18n (en only)
+tests/wsl-*.test.js     # новые регрессии
+CHANGELOG.md, README.md, package.json
+```
+
+---
+
+## Перед merge
+
+1. **Не коммитить** `.claude/settings.local.json` (локальные настройки IDE)
+2. Закоммитить изменения 1.9.0 на `feat/wsl-2.9.3-support`
+3. `npm run translate` — если нужны все локали в релизе
+4. Убедиться, что CI зелёный (`npm test`)
+
+---
+
+## Предлагаемый title
+
+```
+feat: WSL 2.9.3 support, wslc cleanup, and .wslconfig experimental sections (v1.9.0)
+```
+
+## Предлагаемое описание для GitHub (краткое)
+
+```markdown
+## Summary
+- Add WSL Containers (`wslc`) prune task and Health dashboard card (WSL 2.9+)
+- Fix `.wslconfig` editor: write experimental keys to `[experimental]`; add Consomme networking mode
+- Show WSL version in status bar and Health; graceful fallback on older WSL
+- Fix `vscode-old-bins` awk quoting regression and `git-gc` empty path logs
+- Bump version to 1.9.0; 224 tests including backward-compat suite
+
+## Test plan
+- [x] Status bar and Health show WSL version; auto-refresh does not reset to `--`
+- [x] Health → WSL Containers card visible (WSL 2.9.3+)
+- [ ] `wslc-prune`: Advanced → Clean — host prune in log, no failure
+- [ ] Config Editor: `sparseVhd` / `autoMemoryReclaim` saved under `[experimental]`; Consomme networking persists
+- [ ] Legacy `[wsl2]` experimental keys migrate to `[experimental]` on Save
+- [ ] `npm test` (224 passing)
+- [ ] Clean & Compact on WSL 2.9.3 — `vscode-old-bins` succeeds
+- [ ] App works on WSL without `wslc` (task hidden, no errors)
+```