win-hooks

"Linux? Nah. Win-ux!"

Don't let Windows kill your vibe coding flow.

Every Claude Code plugin assumes you're on macOS or Linux.
If you're on Windows, your sessions start with a wall of red errors.
win-hooks fixes that. Automatically. Every session.

---

The Problem

You're on Windows. You install a shiny new Claude Code plugin. You start a session. Then:

SessionStart hook error: /bin/bash: command not found
PreToolUse hook error: scripts/check.sh: No such file or directory
PostToolUse hook error: semgrep: command not found
Stop hook error: ...

Every. Single. Plugin. Written on a Mac. Tested on Linux. Shipped with .sh scripts that Windows has never heard of.

You didn't choose the wrong OS. The ecosystem just forgot about you.

The Fix

Install win-hooks once. Forget about it forever.

claude plugin marketplace add LilMGenius/win-hooks
claude plugin install win-hooks

That's it. Next session, win-hooks silently patches every broken plugin before you even notice. No config. No flags. No manual fixing.

What happens under the hood

Every time Claude Code starts, win-hooks runs a pipeline:

scan all plugins → detect incompatible hooks → generate wrappers → patch hooks.json

1. Scans ~/.claude/plugins/installed_plugins.json for all installed plugins
2. Detects .sh scripts, missing binaries, and Unix-only commands
3. Creates polyglot .cmd wrappers that work on both cmd.exe and bash
4. Patches each plugin's hooks.json (originals backed up as .bak)
5. Skips anything already compatible — safe to run a thousand times

How It Works

The Polyglot Trick

The core innovation is a .cmd file that is simultaneously valid batch and valid bash:

: << 'CMDBLOCK'
@echo off
REM Windows cmd.exe runs this part → finds Git Bash → delegates
"C:\Program Files\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
exit /b %ERRORLEVEL%
CMDBLOCK

# bash runs this part → executes directly
exec bash "${SCRIPT_DIR}/${SCRIPT_NAME}" "$@"

• Windows: cmd.exe ignores the heredoc, runs the batch portion, finds Git Bash, delegates
• macOS/Linux: bash treats : as a no-op, skips to the shell portion, runs natively
• Result: One file. Both platforms. Zero friction.

Wrapper Architecture

plugin/
├── hooks/
│   ├── hooks.json          ← patched to point to _hooks/
│   └── hooks.json.bak      ← original backup
├── _hooks/                  ← win-hooks creates this
│   ├── run-hook.cmd         ← polyglot entry point
│   ├── setup                ← extensionless bash wrapper
│   └── check-tool           ← extensionless bash wrapper
└── scripts/
    └── setup.sh             ← original (untouched)

Wrappers live in a dedicated _hooks/ directory — original plugin files are never modified or overwritten.

Commands

Command	Description
/win-hooks:fix	Manually trigger the patcher (auto-runs at session start)
/win-hooks:status	Show compatibility status of all installed plugins

Plugin Updates

When a plugin updates, its install path changes and patches are lost. This is by design. Restart Claude Code → win-hooks re-detects and re-patches automatically. Zero maintenance.

Requirements

• Windows 10/11 with Git for Windows
• Python 3 — winget install Python.Python.3 or python.org
• Claude Code CLI

Note: win-hooks auto-creates a python3 alias if only python.exe exists — so other plugins that call python3 won't break either.

Components

Project structure

Component	Purpose
hooks/hooks.json	SessionStart hook — triggers auto-patching
hooks/patch-all	Orchestrator — platform check → find python → run pipeline
hooks/run-hook.cmd	Polyglot template — copied to each patched plugin
scripts/find-incompatible.py	Scanner — detects incompatible hooks across all plugins
scripts/apply-patches.py	Patcher — creates wrappers and updates hooks.json
commands/fix.md	/win-hooks:fix command definition
commands/status.md	/win-hooks:status command definition
skills/diagnose/	Diagnostic skill for hook errors

Compatibility rules

Pattern	Verdict	Reason
.cmd in command	COMPATIBLE	Already Windows-native
.sh in command	INCOMPATIBLE	Needs bash wrapper
python3 / node prefix	COMPATIBLE	Interpreter handles it
.py in command	COMPATIBLE	Python file association works
Bare command not in PATH	INCOMPATIBLE	Missing binary

---

Built for the Windows developers who refuse to switch to Mac just to vibe code.

Report Bug · Request Feature · Contribute

License

MIT — Use it, fork it, vibe with it.