# Pi Windows Tools

> Provides Windows-native tool manipulation: shell profiles, path conversion, command execution, WSL bridge, safety policy, and developer tool discovery. Enables Pi to work correctly with PowerShell, cmd, Git Bash, and WSL.

- Skill: `bacnh85/pi-windows-tools` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bacnh85/pi-windows-tools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bacnh85/pi-windows-tools/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: bacnh85 (https://skillmd.com/u/bacnh85)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/bacnh85/pi-windows-tools

---


# pi-windows-tools

Provides Windows-native tool manipulation: shell profiles, path conversion, command execution, WSL bridge, safety policy, and developer tool discovery. Enables Pi to work correctly with PowerShell, cmd, Git Bash, and WSL.

## When to use

- You are working on Windows and Pi needs to execute shell commands
- You need to convert paths between Windows, Git Bash, and WSL formats
- You need to know what developer tools are installed (doctor)
- You want safety checks on dangerous Windows commands
- You need to run commands inside WSL

## Configuration

```powershell
pi install npm:@bacnh85/pi-windows-tools
```

Configure with `PI_WINDOWS_TOOLS_ENABLED`, `PI_WINDOWS_SHELL`, `PI_GIT_BASH_PATH`, and `PI_WSL_DISTRO` environment variables.

## Tools

| Tool | What it does |
|------|-------------|
| `windows_shell_detect` | List available shells with versions |
| `windows_shell_exec` | Execute a command through a specific shell |
| `windows_audit_log` | Show command history and exit codes (`clear: true` empties the log) |
| `windows_path_to_windows` | Convert `/c/` or `/mnt/c/` to `C:\` |
| `windows_path_to_wsl` | Convert `C:\` to `/mnt/c/` |
| `windows_path_to_gitbash` | Convert `C:\` to `/c/` |
| `windows_path_quote` | Quote a path for a specific shell |
| `windows_doctor` | Detect installed developer tools |
| `windows_safety_classify` | Check command for dangerous operations |
| `windows_tool_discover` | Check if a tool exists in PATH |
| `windows_wsl_list_distros` | Show installed WSL distros |

## Commands

- `/windows-doctor` — full system health report
- `/windows-shell [name]` — show or set default shell

## Prompt guidance

On Windows, Pi automatically injects shell-specific syntax guidance (PowerShell by default) so it doesn't generate Bash-only commands.