OpenParable
Skip to content
← Back to skills

Wsl Bridge

Apps & Automation
wsl-bridge

Wsl Bridge is an Agent Skill for apps & automation published in the taracodlabs/aiden repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Run Linux in WSL from Windows; share files between hosts

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/taracodlabs/aiden/blob/HEAD/skills/wsl-bridge/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/wsl-bridge, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

wsl -- ls -la /home/
wsl -- df -h
wsl -- uname -a

Run a bash script in WSL

wsl bash -c "cd /home/user/project && npm install && npm run build"

Pass Windows file to WSL command

# 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

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

List installed WSL distributions

wsl --list --verbose

Check WSL version and status

wsl --status
wsl --version

Shutdown WSL (frees memory)

wsl --shutdown

Set default WSL distribution

wsl --set-default Ubuntu-22.04

Run a specific distro

wsl -d Ubuntu-22.04 -- python3 --version

Forward a port from WSL to Windows

# 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.

"Use awk to sum a column in a CSV" → wsl -- awk -F',' '{sum += $3} END {print sum}' /mnt/c/Users/<you>/data.csv

Cautions

  • WSL 2 uses a virtual machine — memory is not immediately released on process exit; use wsl --shutdown to reclaim RAM
  • File I/O across the Windows/WSL boundary (/mnt/c/) is slower than native Linux filesystem operations
  • Some Linux tools behave differently on WSL vs native Linux (e.g., systemd, Docker daemon)
  • Port forwarding between WSL and Windows host may require adjustments after each WSL restart