¡Bienvenido a WSL Manager! 👋

English | 简体中文 | 繁體中文 | Deutsch | Español | 日本語 | Magyar | Português | Türkçe

_{Mostrado en Windows · la misma app gestiona VMs nativas en macOS — despliega Verlo en macOS más abajo}

WSL Distro Manager es una interfaz gráfica gratuita y de código abierto para el Subsistema de Windows para Linux — y, en macOS, para VMs Linux nativas. Instala, copia, renombra, mueve, respalda y elimina distros de WSL sin memorizar ni una sola opción de wsl.exe — además de plantillas, fragmentos de comandos guardados, montaje de discos, edición de .wslconfig, WSL remoto por SSH y un servidor MCP que permite a los agentes de IA manejar tu entorno WSL. En un Mac, esta misma app gestiona máquinas virtuales a través del framework Virtualization de Apple.

🚀 Características

Gestionar distros

• Instala desde un catálogo integrado o trae tu propio rootfs
• Copia, renombra, mueve a otra unidad, respalda y elimina instancias
• Guarda todas las instancias en una carpeta —con una lista de lo que contiene— y restáuralas en otro PC
• Compacta los discos virtuales para recuperar el espacio que WSL nunca devuelve
• Observa lo que una instancia está consumiendo ahora mismo: procesador, memoria e intercambio, con un gráfico en vivo
• Admite Ubuntu, Debian, Alpine, Kali Linux, openSUSE, SLES y cualquier otra cosa que WSL acepte

Poner instancias en marcha más rápido

• Usa cualquier imagen de Docker como distro — no hace falta Docker
• Empaqueta una distro ya configurada como un archivo .wsl portátil que se instala en cualquier máquina (las plantillas quedan obsoletas frente a esto)
• Turnkey Linux y otros contenedores LXC (experimental)
• Fragmentos: guarda tus comandos de configuración en la app y ejecútalos en cualquier instancia
• Apunta la app a tu propio repositorio de imágenes rootfs
• Explora los archivos de una distro y copia los que elijas a otra instancia — sin recursos compartidos, sin montajes y sin Explorador

Configurar sin editar archivos a mano

• systemd, automount, usuario por defecto, comando y ruta de inicio por distro
• Memoria, procesadores, swap, modo de red, DNS y el resto de .wslconfig
• Monta un disco físico o un VHD en WSL, con control de partición y sistema de archivos
• Compartir carpetas del host en una distro o VM en el punto de montaje que elijas, en solo lectura si quieres — también para el AI Workspace

Trabajar como ya trabajas

• Abre Windows Terminal, VS Code o el Explorador directamente dentro de una distro
• Cada instancia en el menú de Windows Terminal, al día mientras la app está abierta: se añade como un fragmento propio, así que tu configuración de Terminal nunca se modifica
• Gestiona WSL en otra máquina Windows por SSH
• Sincroniza una distro entre dos máquinas de tu red
• Alcanza una instancia por su nombre: su nombre de host se mantiene en el archivo hosts, así que ssh ubuntu.wsl sigue funcionando tras reiniciar
• Se mantiene al día: las versiones de la web y de GitHub descargan e instalan las novedades por su cuenta (las instalaciones de la Store las actualiza la Store)
• Temas oscuro y claro, disponible en nueve idiomas

En macOS: máquinas virtuales nativas (beta)

• La misma app gestiona VMs con el framework Virtualization de Apple en lugar de WSL
• Crea VMs Linux desde una ISO de instalación, una imagen de nube o una plantilla exportada
• Crea VMs invitadas de macOS desde una imagen de restauración (Apple Silicon)
• Arranca, detén, clona, exporta/importa y convierte VMs en plantillas igual que las distros
• Ejecuta comandos dentro de las VMs por SSH aprovisionado automáticamente (cloud-init), desde la interfaz, el chat de IA o clientes MCP
• Una terminal para cualquier VM desde su fila: una sesión SSH en el invitado Linux o macOS, y la consola serie cuando en Linux no hay nada a lo que conectarse
• Tu propia clave de ~/.ssh queda autorizada en cada VM Linux (y se crea si no tienes ninguna), así que un simple ssh usuario@ip-vm también funciona
• Cada VM recibe una contraseña de acceso que puedes consultar en su fila, para iniciar sesión en la pantalla de la propia VM
• Define en esa misma fila la cuenta con la que inicia sesión cada ruta SSH: el nombre de un invitado macOS se escribe en el Asistente de Configuración, donde la app no puede verlo
• Compila con scripts/build_macos.sh — incluye el ayudante vmctl firmado

Pro (pago único: Microsoft Store en Windows, clave de licencia en wslmanager.com/buy para macOS y para instalaciones fuera de la Store — nunca una suscripción)

• AI Workspace — ejecuta Hermes Agent, OpenClaw, Open WebUI y OpenCode en una distro de WSL dedicada y aislada
• Un modelo y endpoint para todas las herramientas de IA — el endpoint de la API, la clave y el modelo del asistente definidos en Ajustes son los que usan también OpenCode, OpenClaw y Hermes; defínelos una vez y una herramienta instalada después también los recibe
• Asistente de IA con herramientas — el chat integrado puede operar tu WSL de verdad: lista e inspecciona distros, ejecuta comandos, edita la configuración, crea fragmentos, monta discos y empaqueta distros con las mismas herramientas que expone el servidor MCP
• Cada ejecución de la IA que cambia una instancia se guarda como fragmento — con los comandos ejecutados y lo que informó cada herramienta, enlazado desde el chat, para que puedas revisarla, repetirla en una instancia nueva o compartirla
• IA en un sandbox — levanta una distro Ubuntu desechable y da a un chat de IA acceso solo al interior de ese sandbox
• Cola de tareas — entrégale al asistente una lista y déjalo trabajar, marcando cada punto a medida que avanza
• Servidor MCP — expón WSL a Claude Desktop, Claude Code, opencode y otros clientes MCP
• Panel web — gestiónalo todo desde tu teléfono u otro ordenador: escanea un código QR, obtén la app entera en un navegador y publícala opcionalmente fuera de tu red mediante un túnel de Cloudflare

Las funciones de IA usan credenciales que aportas tú — tu propia clave de API compatible con OpenAI. No se aloja ni se incluye ningún servicio de IA, no hay cuota y ninguna petición pasa por servidores ajenos. Pro desbloquea las funciones en la app; no compra crédito de IA. Consulta Free vs Pro.

¿Por qué existe una versión de pago? WSL Manager es, desde 2021, un proyecto de una sola persona hecho en su tiempo libre, y cada función de arriba — también las gratuitas — se construyó por las tardes y los fines de semana. Gestionar tus distros y VMs es gratis y seguirá siéndolo, y toda la app sigue siendo de código abierto. Pro es la capa de IA que va encima, y lo que aporta es lo que convierte el mantenimiento y las nuevas funciones en trabajo planificado y regular en lugar del tiempo que sobre. Cómpralo una vez, consérvalo para siempre, y estarás financiando directamente la próxima versión.

🤖 Asistente de IA y MCP (Pro)

Todo lo de esta sección forma parte de Pro; la app gratuita no incluye nada de esto.

El asistente de IA es un agente, no una simple caja de chat: recibe el mismo conjunto de herramientas que expone el servidor MCP, así que cuando preguntas «¿qué distros tengo?» o «instala Ubuntu y configura mi usuario por defecto», llama a herramientas reales contra tu WSL en lugar de adivinar. Las llamadas a herramientas se muestran en línea mientras trabaja.

Configura el proveedor en Ajustes → Bring Your Own AI Key: sirve cualquier endpoint compatible con OpenAI (OpenAI, Azure, un proxy LiteLLM, Ollama, LM Studio, …). Introduce la URL base, la clave y el modelo. El botón Cargar lista de modelos rellena un autocompletado desde el /models del proveedor, y Probar conexión demuestra que las credenciales funcionan antes de abrir el chat.

¿No quieres nada de esto? Ajustes → Bring Your Own AI Key → Funciones de IA desactiva el asistente, el diagnóstico de errores y el AI Workspace: no se muestra nada relacionado con la IA y no se prepara ningún entorno de trabajo por ti. Está desactivado hasta que respondas: WSL Manager lo pregunta una vez, en el primer inicio tras instalar o actualizar, y antes de eso no se ejecuta nada relacionado con la IA.

Sandboxes (AI Workspace → Añadir distro sandbox) crean una instancia desechable a partir de cualquier imagen del catálogo (el Ubuntu más reciente por defecto) — una distro de WSL en Windows, una VM Linux partiendo de una imagen de nube en macOS, que se crea y arranca por ti. A su chat solo se le entregan las herramientas sandbox_*, limitadas a esa única instancia: el modelo puede hacer cualquier cosa dentro del sandbox y nunca ve tu anfitrión ni ninguna otra instancia. Una salvedad honesta: el sandbox en sí tiene acceso normal a internet hacia fuera, como cualquier distro o VM. Los chats de sandbox usan el mismo panel acoplado que el asistente (cola de tareas incluida), sus transcripciones persisten, y el botón de historial de la cabecera del chat alterna entre el asistente y cualquier sesión de sandbox.

Cola de tareas — abre la sección Tareas en la parte superior del chat, añade elementos y pulsa ▶. El asistente los recorre con sus herramientas y va marcando cada uno al terminarlo; puedes seguir añadiendo tareas mientras trabaja.

Conectar clientes de IA externos (MCP)

Activa Ajustes → Servidor MCP (Pro). Sirve el protocolo MCP en http://127.0.0.1:59133/mcp, solo en loopback y protegido por un token bearer que se muestra en el mismo panel. Las herramientas cubren el ciclo completo: crear, importar, configurar, ejecutar, empaquetar y (con una marca de confirmación) dar de baja distros, además de fragmentos, montaje de discos y sesiones de terminal persistentes.

Claude Desktop — pulsa Conectar Claude Desktop en el panel MCP. Escribe por ti la entrada de abajo en claude_desktop_config.json (necesita Node.js); reinicia Claude Desktop después. Para hacerlo a mano, o para cualquier otro cliente MCP por stdio, puentea el endpoint HTTP con mcp-remote:

// claude_desktop_config.json  (%APPDATA%\Claude\)
{
  "mcpServers": {
    "wsl-manager": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "http://127.0.0.1:59133/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer <TOKEN FROM THE MCP PANEL>" }
    }
  }
}

Claude Code — el mismo puente, un solo comando:

claude mcp add wsl-manager -- npx -y mcp-remote http://127.0.0.1:59133/mcp \
  --header "Authorization: Bearer <TOKEN>"

opencode — añádelo bajo mcp en tu opencode.json (o ~/.config/opencode/opencode.json):

{
  "mcp": {
    "wsl-manager": {
      "type": "local",
      "command": ["npx", "-y", "mcp-remote", "http://127.0.0.1:59133/mcp",
                  "--header", "Authorization: Bearer <TOKEN>"]
    }
  }
}

Cualquier cliente MCP que hable HTTP en streaming puede apuntar directamente al endpoint con una cabecera Authorization: Bearer <TOKEN>, sin pasar por mcp-remote. Para llegar a él desde otra máquina, activa el túnel de Cloudflare integrado en ese mismo panel y usa la URL pública que imprime.

📱 Panel web (Pro)

Activa Ajustes → Panel web (Pro) y la app servirá un panel de navegador en el puerto 59134 para todos los dispositivos de tu red, tanto en Windows como en macOS. Escanea con el móvil el código QR que muestra el panel (o copia el enlace) y tendrás la app entera en un navegador: arrancar, detener, duplicar y eliminar instancias, ejecutar comandos, abrir sesiones de terminal persistentes, lanzar tus fragmentos guardados y manejar todas las demás herramientas (importar, exportar, empaquetado, .wslconfig, discos, creación de VMs) mediante formularios generados. Es el mismo conjunto de herramientas que usan el asistente de IA y el servidor MCP.

El acceso está protegido por un token que forma parte del enlace (?token=…), de modo que un código QR escaneado es todo lo que necesita un dispositivo — y regenerar el token en el panel revoca todos los enlaces repartidos hasta entonces. El panel escucha en todas las interfaces a propósito; activa Publicar mediante túnel de Cloudflare en ese mismo sitio para obtener un enlace HTTPS público temporal (el código QR cambia a él) cuando lo necesites fuera de casa. Una vez publicado, el token es lo único que protege una superficie capaz de ejecutar comandos, así que comparte ese enlace con cuidado.

📦 Instalación

brew install --cask wsl-manager

winget install Bostrot.WSLManager

scoop install extras/wsl2-distro-manager

choco install wsl2-distro-manager

⚙️ Build

Asegúrate de tener flutter instalado.

Windows

flutter config --enable-windows-desktop
flutter upgrade

flutter build windows # build it
flutter run -d windows # run it

macOS

Las VMs las crea vmctl, un pequeño ayudante en Swift que maneja Virtualization.framework — no la app de Flutter. El framework solo responde a procesos que llevan el permiso com.apple.security.virtualization, y swift build no lo añade, así que el ayudante debe compilarse y firmarse antes de que la app pueda arrancar una VM:

flutter config --enable-macos-desktop

# Build + sign vmctl and install it for dev runs. Re-run after any change
# under macos/vmctl/ — `flutter run` never rebuilds the helper.
VMCTL_ONLY=1 scripts/build_macos.sh

flutter run -d macos

Si te saltas ese paso, la app se abre sin problemas, pero arrancar una VM falla con:

VM failed to start: Error Domain=VZErrorDomain Code=2 "The process doesn't
have the "com.apple.security.virtualization" entitlement."

Es el ayudante al que le falta el permiso, no la app: los permisos de Runner ya son correctos. El ayudante firmado se instala en ~/Library/Application Support/WSLManager/bin/vmctl, que es donde lo buscan las ejecuciones de depuración; sin él, recurren a la salida sin firmar de swift build en macos/vmctl/.build/, que es lo que produce el error anterior.

scripts/build_macos.sh sin VMCTL_ONLY hace la misma firma y luego compila la app de release, incluyendo el ayudante firmado en Contents/Resources/ del bundle. Compilar la app en sí requiere Xcode completo.

Autor

👤 Eric Trenkel

• Sitio web: erictrenkel.com
• GitHub: @bostrot
• LinkedIn: @erictrenkel

👥 Colaboradores

🤝 Contribuir

¡Las contribuciones, informes de errores y peticiones de funciones son bienvenidos!
Echa un vistazo a la página de issues. También puedes consultar la guía de contribución.

Muestra tu apoyo

¡Danos una ⭐️ si este proyecto te ha ayudado!

📝 Licencia

Copyright © 2026 Eric Trenkel.
Este proyecto tiene licencia GPL-3.0.

¿No has encontrado lo que buscabas? Echa un vistazo a la Wiki