Windows auto-patcher for vibe coders.
win-hooks repairs the plugin hooks that break on your Windows machine.
Automatically, at every session start, and again for ones added later.
Pick your tool and paste one line.
Claude Code
claude plugin marketplace add LilMGenius/win-hooks && claude plugin install win-hooksCodex
codex plugin marketplace add LilMGenius/win-hooks && codex plugin add win-hooks@win-hooksNeither, just fix my plugins now
npx @lilmgenius/win-hooksThat's the whole setup. No config, no flags, nothing to remember.
You need Windows 10/11 and Git for Windows. Node.js already comes with Claude Code and Codex.
You installed a plugin. It works fine for everyone on a Mac. On your machine it greets you with red text every time you open a session.
| The error you see | What was wrong |
|---|---|
check.sh: No such file or directory |
Windows can't run a .sh script directly |
semgrep: command not found |
The plugin expects a Unix tool you don't have |
'node' is not recognized |
Works in Git Bash, invisible to the process that launches hooks |
Python was not found; ... Microsoft Store |
Windows' fake python3 placeholder shadowing your real one |
JSON Parse error: Unrecognized token |
An invisible byte (BOM) at the top of a config file |
Cannot find module 'C:\Users...' |
Backslashes in a path getting eaten before the hook runs |
None of that is your fault. Almost every plugin is written and tested on macOS or Linux, so its hooks assume Unix tools that Windows does not have.
win-hooks repairs your plugins at every session start, including ones you install later and ones that break again after an update. Repairs are written next to the original file, never on top of it, and anything already working is left alone.
A healthy run is silent. To look anyway:
| Command | What it does |
|---|---|
/win-hooks:patch |
Checks every plugin, shows what it found, repairs anything broken |
npx @lilmgenius/win-hooks patch |
The same, from any terminal |
win-hooks runs entirely on your machine and sends nothing anywhere. No telemetry, no network calls, no account. Outside a plugin's own folder it writes only a short local log of its own runs, so you can confirm it ran.
MIT. How it works, and every failure mode it handles: AGENTS.md.