fix(ralph-wiggum): Windows 11 compatibility for stop-hook.sh

[oinani0721]

Summary

• Add PATH fix for Git Bash subprocess environment on Windows
• Add UTF-8 encoding exports for non-ASCII paths (Chinese characters)
• Extract cwd from hook input and use absolute paths
• Add cygpath normalization for Windows paths
• Change rm to rm -f to avoid race condition errors
• Fix output to stderr with exit code 2

Problem

Ralph Wiggum plugin fails on Windows 11 with multiple issues documented in #16377

Test plan

• Tested on Windows 11 with Git Bash
• Ralph loop iteration 1 â�� 2 â�� 3 â�� normal exit works
• Non-ASCII paths (Chinese characters) work correctly

Related: anthropics/claude-code#16377

[oinani0721]

Additional Findings After Initial PR

After more testing, I discovered additional issues and solutions that complement this PR:

🔍 New Discovery: Plugin Cache Conflict

Even with this fix applied to the plugin source, outdated cached versions can override the fix!

Claude Code caches plugin files in multiple locations:

• ~/.claude/plugins/cache/claude-plugins-official/ralph-wiggum/
• ~/.claude/plugins/marketplaces/*/plugins/ralph-wiggum/

Workaround for users: Delete cached directories to force reload:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\plugins\cache\*\ralph-wiggum" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\plugins\marketplaces\*\plugins\ralph-wiggum" -ErrorAction SilentlyContinue

📋 Complete Windows 11 Setup Checklist

For users to get ralph-wiggum working on Windows 11, they need:

1. ✅ This PR merged (fixes the stop-hook.sh script)
2. ✅ Environment variable set:

   CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
   

3. ✅ Clear plugin cache (see workaround above)
4. ✅ Restart Claude Code

🔗 Related Issues

I've posted detailed solutions in these Claude Code issues:

• [BUG] Hook .sh scripts open in VSCode instead of executing on Windows Terminal/PowerShell claude-code#9758 - Complete Windows 11 fix guide
• [Ralph Wiggum Plugin] Windows 11 Compatibility Fixes for Stop Hook claude-code#16377 - Original issue report
• ralph-loop plugin: Windows compatibility issue - stop-hook.sh cannot execute claude-code#17257 - ralph-loop Windows compatibility
• Ralph Wiggum plugin: undocumented jq dependency breaks Windows/Git Bash users claude-code#14817 - jq dependency
• Ralph Loop plugin: stop-hook.sh fails on Windows - cat command not found claude-code#16560 - cat command not found

✅ Verified Working

Tested on Windows 11 23H2:

• ralph-loop iteration: ✅ Works (1/2 → 2/2 → complete)
• Non-ASCII paths: ✅ Works (Chinese characters in path)
• Stop hook execution: ✅ Silent (no script content displayed)

[Unic-hou]

Thank you . i resolve this problem.

[reisen7]

perfect fix，love u

[MithrilMind]

A month in, still waiting. Can we nudge the Claude team