security-guidance plugin fails on Windows: python3 command not found

Resolved 💬 3 comments Opened Jan 3, 2026 by papacrypt Closed Jan 3, 2026

Description

The security-guidance plugin hook fails on Windows with:

PreToolUse:Edit says: Plugin hook error: 'python3' is not recognized as an internal or external command, operable program or batch file.

Environment

  • OS: Windows
  • Claude Code: latest
  • Plugin installed via: /plugins command within Claude Code
  • Python: 3.14.0 installed and working (python command works)

Cause

The hook in plugins/security-guidance/hooks/hooks.json hardcodes python3:

"command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/security_reminder_hook.py"

On Windows, Python is invoked as python, not python3. Even with Python correctly installed and in PATH, python3 doesn't exist:

> where python
C:\Users\...\Python314\python.exe

> where python3
INFO: Could not find files for the given pattern(s).

This is standard Windows behavior - the python3 symlink is a Unix/Linux/macOS convention.

Suggested Fix

Use python instead (works cross-platform when Python 3 is the installed version), or add platform detection.

Workaround

Create a python3.bat file somewhere in your PATH containing:

@"C:\Path\To\Your\python.exe" %*

This aliases python3 to your Python installation.

---

P.S. This issue was drafted with help from Claude, but it seemed confident this was worth raising.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗