fix(hookify): `python3` command not found on Windows - hooks fail to execute
Author: MuminurCreated Dec 31, 2025Updated Sep 15, 2026
Bug Description
The Hookify plugin fails on Windows because the hooks.json file uses python3 as the Python interpreter command. On Windows, Python is invoked using python or py, not python3.
Environment
- OS: Windows 10/11
- Python Version: 3.13 (installed via official Python installer)
- Claude Code Version: Latest
- Plugin: hookify@claude-plugins-official
Error Message
Plugin hook error: 'python3' is not recognized as an internal or external command,
operable program or batch file.Steps to Reproduce
- Install Claude Code on Windows
- Install the hookify plugin:
/plugin install hookify@claude-plugins-official - Use any command that triggers a hook (e.g., UserPromptSubmit)
- Observe the error about
python3not being recognized
Root Cause
In plugins/hookify/hooks/hooks.json, all hook commands use python3:
{
"command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.py",
...
}On Windows:
python3→ ❌ Command not foundpython→ ✅ Workspy→ ✅ Works (Python Launcher)
Proposed Solution
Change all instances of python3 to python in plugins/hookify/hooks/hooks.json:
"command": "python ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.py"On modern systems:
- Windows:
pythoninvokes Python 3.x - macOS/Linux: Most systems have
pythonsymlinked topython3
Affected Files
plugins/hookify/hooks/hooks.json(4 occurrences ofpython3)
Related Issues
- #82 - Bug: Plugin installation fails on Windows (may be related)
- #78 - ralph-wiggum stop-hook fails with "cat: command not found" on macOS (similar cross-platform issue)
Source: anthropics/claude-plugins-official