winure/README.md

# Winure: WSL inurement tools

These are tools I use to use Windows primarily through WSL. Many are
cross-dependent.

## `dos-var`

Gets Windows environment variables from DOS.

## `env-share`

A hacked-together utility for sending WSL variables back to Windows
shells. The utility runs in WSL, and companion scripts run in Windows.

## `hug`

A barebones command wrapper for turning binary-output text into normal text.

## `mkwin`

A Linux utility to quickly make a bash script to run a Windows executable with
certain parameters.

## `path-convert`

A Linux utility to canonicalize and convert paths from Unix to DOS, which makes
it easier to open programs like explorer from WSL. This solves hiccups from
paths like missing support for symbolic links, mismatched path separators,
inability to handle spaces in directory names, and resolves C-drive paths to
their normal DOS form.

## `qdls`

A feature-barren DOS clone of `ls` that hides Windows hidden files. Relies on
`dotnet-warp` as a build dependency.

---

## Scripts

- `charmap.sh`: Simple wrapper for Character Map.
- `cmd.sh`: Simple wrapper for `cmd.exe`.
- `dos.sh`: Simple wrapper for executing Windows commands directly.
- `elevate.sh`: Elevate WSL (`-l`) or Windows (`-w`) commands from WSL.
- `explorer.sh`: Launch explorer from WSL.
- `pwsh.sh`: Launch PowerShell Core.
- `sqlcmd.sh`: Simple wrapper for `sqlcmd.exe`.
- `wsl.sh`: A wrapper for `wsl.exe` that wraps in `hug` when piped.
- `wt.sh`: Launch Windows Terminal.

---

## Windows Man Pages

- `cmd(8)`: `cmd.exe`
- `wt(1)`: Windows Terminal