scorpiox-wsl 📦 container

Platforms: windows-x64

WSL2 stateless execution bridge for Windows. Launches Linux commands and workflows inside WSL2 distributions from native Windows without persistent state, enabling seamless cross-platform development pipelines.

⚙️ Flags & Options (1)

Flag Short Description Takes Value
--verbose Enable verbose logging output for debugging WSL bridge operations No

💻 Usage Examples

# Run a single command inside default WSL2 distro
PS> scorpiox-wsl -- ls -la /home

# Execute a build script statelessly
PS> scorpiox-wsl -- bash -c "cd /mnt/c/project && make clean && make"

# Run with verbose logging to debug bridge behavior
PS> scorpiox-wsl --verbose -- gcc -o app main.c
[wsl-bridge] attaching to distro: Ubuntu-22.04
[wsl-bridge] executing: gcc -o app main.c
[wsl-bridge] exit code: 0
# Pipe data from Windows into a Linux command
PS> type data.csv | scorpiox-wsl -- awk -F',' '{print $1,$3}'

# Run a scorpiox tool chain inside WSL2
PS> scorpiox-wsl -- scorpiox-cc --target linux-x64 -o myapp src/main.c

# Execute Python scripts from Windows through WSL
PS> scorpiox-wsl -- python3 /mnt/c/scripts/deploy.py --env staging
# Chain multiple commands in a stateless session
PS> scorpiox-wsl -- sh -c "apt list --installed 2>/dev/null | grep -c '^' "
347

# Use in CI/CD pipelines — test Linux builds from Windows runner
PS> scorpiox-wsl --verbose -- bash ci/test-linux.sh
[wsl-bridge] session started (stateless)
[wsl-bridge] running tests...
[wsl-bridge] all 42 tests passed
[wsl-bridge] session terminated — no state persisted

📁 Source & Build Info

Source File
scorpiox/scorpiox-wsl.c
Lines of Code
1,550
Dependencies
libsxutil, mbedtls

🔗 Related Tools