powershell-fix

The most common pitfall when AI agents run on Windows is pasting bash-flavored commands straight into a PowerShell terminal—export NAME=value, /dev/null, backslash continuations, ls -la. Any single incompatibility wastes an entire tool-call round-trip. powershell-fix is a host-layer plugin for DeepSeek Harness that detects, repairs, and safely executes such commands before they reach the shell, absorbing the syntax friction silently in the background.

Its core capabilities span three layers. First, line-level hygiene: CRLF remnants are normalized, pasted shell prompts are stripped, invisible whitespace around continuation characters is removed, and bash backslash continuations are converted to PowerShell backticks. Second, semantic translation: common bash idioms—export, unset, > /dev/null, &&, ls -la, rm -rf, mkdir -p, grep, head/tail, which—are mapped to their precise PowerShell equivalents, with automatic detection of whether the target is PowerShell 7 or Windows PowerShell 5.1 to choose the correct operator. Third, a safety gate: destructive commands such as rm -rf /, Format-Volume, Set-ExecutionPolicy, and registry writes are refused for auto-execution even after their syntax is corrected; the plugin outputs the fixed command for human review instead.

It is designed for developers running AI-agent workflows on Windows: install the plugin into a profile and every session on that profile picks up the powershell_fix tool automatically, with no agent-preset changes required. The engine has zero runtime dependencies (pure JavaScript), correct commands pass through unchanged (no-op guarantee), and the fixer is fully idempotent—fix(fix(x)) always equals fix(x).