Skip to content

Open source

WSL Linker

Open-source Windows GUI + CLI that links Windows host directories straight to the WSL 2 Linux filesystem via native symlinks. Restores zero-latency, native-Linux-speed dev when WSL Remote breaks.

Role
Creator · Solo build
Period
2026 — present
Stack
Python · CustomTkinter · PyInstaller · Wine + Docker · and 3 more
Place
OSS, MIT licensed
WSL Linker — Workspace Manager. Active registry mappings on the left, Link New Workspace flow on the right, live activity console at the bottom.

WSL Linker — Workspace Manager. Active registry mappings on the left, Link New Workspace flow on the right, live activity console at the bottom.

MITFully open source

When Google's Antigravity IDE jumped to 2.0, the entire editor surface was restructured and the standard WSL Remote Plugin workflow disappeared overnight. Developers who lived inside WSL 2 (for native Linux Git, Docker, npm performance) were suddenly stranded.

01 / 03

The problem

Moving the code back onto the Windows host wasn't an option — cross-OS disk access (`/mnt/c/` from inside WSL) degrades Git, Docker, and npm by up to 10×. The files had to stay on the ext4 partition; only the editor's view of them needed to change.

Downstream payoff — a WSL-Linker symlink showing up as a Claude Desktop "Linked Directory" at `\\wsl.localhost\ubuntu-24.04\home\fauzul\code\OSS\wsl-linker`. Native host tools see the WSL repo as a local folder.
02 / 03

What I built

  • Native Windows directory symlinks from any host folder straight to `\\wsl.localhost\Ubuntu-24.04\home\user\project` — zero duplication, zero latency.
  • Fluent Dark Mode GUI in CustomTkinter — sleek parent-directory onboarding, live path preview that turns emerald green when ready, auto-wrapping card mappings.
  • CLI proxy runner. `wsl-linker run npm install` executes the command inside the corresponding WSL directory from a Windows shell — context-drop with one verb.
  • Single-file .exe via PyInstaller. Compiled inside an isolated Wine + Docker container so the host stays clean. `make build-docker` and ship.
  • Safe unlinker. Uses `os.rmdir` to untether the junction without ever recursing into the WSL target — the most important line of code in the project.
03 / 03

What I learned

A breaking IDE update is also a product opportunity.

The fix didn't need to be inside the editor — a single-purpose desktop utility with the right scope unblocked the entire workflow.

Open source as scratch-your-own-itch: the tool I needed for myself ships under MIT so anyone burned by the same IDE migration can clone, fork, or redistribute the .exe.

Decisions and why

  1. Symlinks instead of file copy / sync

    WhyAny sync-based bridge introduces a second source of truth and inevitable drift. A native directory junction is one filesystem entry, atomic, and the OS handles every read and write.

  2. Ship as a single .exe, not a Python package

    WhyThe people who need this most — designers, QA, junior devs — should not have to install Python, PyInstaller, or configure WSL path shares. Double-click and link.

Technical highlights

  • 01

    Native Windows directory symlinks (mklink /D) targeting WSL 2 UNC paths.

  • 02

    CustomTkinter-based Fluent Dark theme with live `<Configure>` event reflow.

  • 03

    PyInstaller single-file build inside a Wine Docker container — reproducible, host-clean.

  • 04

    CLI proxy that routes shell commands across the Windows ↔ WSL boundary.

Impact

  • Restored developer workflows for a community stranded by an upstream IDE migration.
  • Cross-functional teammates (designers, QA) can now preview and edit WSL-resident projects without learning the WSL CLI.
  • Zero dependency footprint on host — MIT-licensed redistribution makes it safe to bundle into a team onboarding kit.
Outcomes

By the numbers.

10×
Build speed vs /mnt/c
1
Single-file .exe
Visit project

See it in the wild.

This case study covers how WSL Linker was built — these links open what ships today: the live product, repo, demos, and supporting material.

Recent activity

The changelog.

June 2026
Jun 2026
wrote:Paxel Was Missing Half My Sessions — Here's How I Fixed It
Notes
May 2026
May 2026
released:WSL Linker · v1.0 — remove unsupported hover_text_color argument from CTkButton (customtkinter 5.2.2 compat)9 commits · May 2026
GitHub ↗
↗ Next case study

Blur Studio

Blur Studio applies Gaussian blur with soft feathered edges to exact regions of a photo — ellipses, rectangles, or hand-painted grid tiles — and carves out rectangular VIP boxes that stay perfectly sharp even when they overlap a blurred region. It exists because a real launch nearly stalled on exactly this problem, and generative retouching made photos look less real, not more usable. The engine that resulted ships three ways: a glass-UI web app for dragging and painting by hand, a scriptable CLI for shell pipelines, and an MCP server so an AI agent can look at a photo with its own vision and call the exact same tool directly.