MacOS 26 install issue - Installation Instructions for macOS with Modern Python (PEP 668)

[tonydehnke]

I had a hard time getting this installed on MacOS 26 with the readme as is. Claude walked me through some ideas to get it working, here is it's suggestion:

Installation Instructions for macOS with Modern Python (PEP 668)


## Issue
The current installation documentation uses pip install -e . which fails on modern macOS systems with the error:

error: externally-managed-environment


This is due to PEP 668 protections in modern Python versions that prevent modifying the system Python.

What Worked

Since the project doesn't have a setup.py or pyproject.toml file, the solution was to:

1. Clone the repository locally
2. Copy the script directly to the PATH:

cd ~/Downloads/CCNotify
chmod +x ccnotify.py
cp ccnotify.py /usr/local/bin/ccnotify

	3.	Verify installation:

ccnotify --help

	4.	Continue with normal setup (terminal-notifier and hooks configuration)
Recommendation
	•	Add a ⁠pyproject.toml file to the project (this would allow ⁠pipx install git+... to work properly)
	•	OR update the README to document the manual installation approach above for users on macOS with modern Python
	•	OR provide installation via Homebrew
Environment
	•	macOS 26
	•	Python 3.x (system-managed)
	•	pip with PEP 668 enforcement enabled