win-cmd-fixer

Convert problematic shell commands into Windows-compatible ones.

Have you ever used a deep-agent, or pasted an AI-generated command, then got errors like "cannot find the path" or "syntax is incorrect"?

That command made perfect sense — but Windows CMD just wouldn't cooperate.

Then this tool is for you.

Features

• Fix unquoted paths with spaces (e.g. dir C:\Program Files → dir "C:\Program Files")
• Auto-add /d flag for cross-drive cd
• Translate Unix command names to their Windows equivalents (cp → copy, ls → dir, etc.)
• Three output targets: Windows CMD, PowerShell 5.x, and Unix shell
• Handles chained commands with &&, ||, |, >, >> separators
• Supports 20+ commands: cd, dir, copy, move, del, type, mkdir, rmdir, rename, echo, find, findstr, cls, more, xcopy, pushd, popd, where, and their Unix aliases
• Already-correct commands pass through unchanged
• Unknown commands are emitted verbatim (never crashes)
• Zero dependencies — both the Python and TypeScript packages are fully standalone
• Available in both Python and TypeScript

Installation

Python

pip install win-cmd-fixer

TypeScript / JavaScript

npm install win-cmd-fixer

Usage

Python

from win_cmd_fixer import fix_cmd, fix_powershell, fix_unix_shell

# Fix for Windows CMD
fix_cmd('cd D:\\Program Files\\project')
# => 'cd /d "D:\\Program Files\\project"'

fix_cmd('cp -r D:\\Program Files\\src C:\\Program Files\\dst')
# => 'robocopy /e "D:\\Program Files\\src" "C:\\Program Files\\dst"'

# Fix for PowerShell 5.x
fix_powershell('cd D:\\Program Files\\project')
# => 'Set-Location "D:\\Program Files\\project"'

fix_powershell('rm -rf D:\\Program Files\\old')
# => 'Remove-Item "D:\\Program Files\\old" -Recurse -Force'

# Fix for Unix shell (e.g. Git Bash, WSL)
fix_unix_shell('dir D:\\Program Files\\')
# => 'ls "/d/Program Files/"'

TypeScript / JavaScript

import {fixCmd, fixPowershell, fixUnixShell} from 'win-cmd-fixer';

// Fix for Windows CMD
fixCmd('cd D:\\Program Files\\project');
// => 'cd /d "D:\\Program Files\\project"'

fixCmd('cp -r D:\\Program Files\\src C:\\Program Files\\dst');
// => 'robocopy /e "D:\\Program Files\\src" "C:\\Program Files\\dst"'

// Fix for PowerShell 5.x
fixPowershell('cd D:\\Program Files\\project');
// => 'Set-Location "D:\\Program Files\\project"'

// Fix for Unix shell
fixUnixShell('dir D:\\Program Files\\');
// => 'ls "/d/Program Files/"'

What It Fixes

API Reference

Python

TypeScript

Contributing

Contributions are welcome! Especially:

• New edge cases you've encountered
• Better heuristics for path detection
• Support for more commands or shell variations

Setup

git clone https://github.com/RockeyDon/win-cmd-fixer.git
cd win-cmd-fixer

Python

cd python
python -m venv .venv
.venv\Scripts\activate    # Windows
pip install -e ".[dev]"
pytest tests/

TypeScript

cd typescript
npm install
npm test

Build & Publish

A single PowerShell script handles both packages:

# Build only (dry run)
.\publish.ps1

# Build and publish to PyPI + npm
.\publish.ps1 -Publish

# Publish Python to TestPyPI, npm dry-run
.\publish.ps1 -Publish -TestPyPI

License

MIT