# Wsl Bridge

Run Linux in WSL from Windows; share files between hosts

- Repository: https://github.com/taracodlabs/aiden (868 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add taracodlabs/aiden --skill wsl-bridge -g -a claude-code -y`
Codex: `npx skills add taracodlabs/aiden --skill wsl-bridge -g -a codex -y`
Cursor: `npx skills add taracodlabs/aiden --skill wsl-bridge -g -a cursor -y`
Gemini CLI: `npx skills add taracodlabs/aiden --skill wsl-bridge -g -a gemini-cli -y`

## Description

Run Linux in WSL from Windows; share files between hosts

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# WSL Bridge

Invoke Linux commands from Windows, pass data between WSL and Windows filesystems, and manage WSL distributions, without switching terminals.

## When to Use

- User wants to run a Linux command (grep, awk, sed, curl) from Windows
- User asks to install or manage a WSL distribution
- User needs to access Windows files from WSL or vice versa
- User wants to run a bash script via WSL
- User asks about WSL status, memory usage, or network config

## How to Use

### Run a Linux command from PowerShell
```powershell
wsl -- ls -la /home/
wsl -- df -h
wsl -- uname -a
```

### Run a bash script in WSL
```powershell
wsl bash -c "cd /home/user/project && npm install && npm run build"
```

### Pass Windows file to WSL command
```powershell
# Convert Windows path to WSL path
$winPath = "C:\Users\<you>\data.csv"
$wslPath = wsl wslpath -u $winPath
wsl -- cat $wslPath | wsl -- grep "ERROR"
```

### Access Windows drive from WSL
```powershell
# Windows C: drive is mounted at /mnt/c inside WSL
wsl -- ls /mnt/c/Users/<you>/Documents
```

### List installed WSL distributions
```powershell
wsl --list --verbose
```

### Check WSL version and status
```powershell
wsl --status
wsl --version
```

### Shutdown WSL (frees memory)
```powershell
wsl --shutdown
```

### Set default WSL distribution
```powershell
wsl --set-default Ubuntu-22.04
```

### Run a specific distro
```powershell
wsl -d Ubuntu-22.04 -- python3 --version
```

### Forward a port from WSL to Windows
```powershell
# Get WSL IP
$wslIp = (wsl -- hostname -I).Trim()
Write-Host "WSL IP: $wslIp"
# Use netsh to forward (requires elevated session)
# netsh interface portproxy add v4tov4 listenport=3000 listenaddress=0.0.0.0 connectport=3000 connectaddress=$wslIp
```

## Examples

**"Run grep on a log file using WSL"**
→ `wsl -- grep -i "error" /mnt/c/logs/app.log | wsl -- tail -n 50`

**"What WSL distros do I have installed?"**
→ `wsl --list --verbose`, shows name, state, and WSL version for each distro.

The rest: https://github.com/taracodlabs/aiden/blob/HEAD/skills/wsl-bridge/SKILL.md