@4fu/pi-pwsh

This Skill addresses the poor terminal command compatibility when using AI coding agents in Windows environments. In actual development, Git Bash often fails due to background process hangs or path conversion errors, while models tend to output POSIX syntax (e.g., &&, grep, $VAR) that cannot run directly in PowerShell. This Skill disables built-in tools like bash, ls, find, and grep, and registers a pwsh tool based on PowerShell 7, ensuring all shell, directory listing, and search tasks execute reliably on Windows.

Usage is straightforward: simply install this Skill in your AI coding agent, after which all terminal commands will automatically execute via pwsh -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command <cmd>. It retains features of the built-in bash tool—such as tail truncation, output saving, non-zero exit code error prompts, and streaming preview—while only replacing the process launch layer. Additionally, it provides persistent ConPTY sessions (via functions like Start-Pty), background job support, automatic retry for .cmd batch files, process tree termination, UTF-8 without BOM output, and native exit code preservation.

It is ideal for teams and individuals performing backend development, operations management, or full-stack development on Windows—especially developers who already use PowerShell 7 as their primary shell but want AI coding agents to correctly understand and execute PowerShell commands. For scenarios involving long-running background tasks (e.g., npm run dev), cross-platform script compatibility, or reliance on precise exit codes (e.g., rg, git diff --quiet), this Skill significantly reduces command execution failures and debugging time.

We recommend standardizing on this tool in Windows development environments to avoid inconsistencies from mixing Git Bash and PowerShell. Note that it is primarily designed for Windows and not suitable for Linux or macOS. Also, it has no default timeout; models can set timeouts via the timeout parameter as needed. If Windows Sudo is enabled, models can prefix commands with sudo to run with administrator privileges (subject to UAC prompt approval).