Releases: Helmi/CCNotify
Releases · Helmi/CCNotify
v0.1.13 - False Notification Fixes
Highlights
- Fixed false error notifications for NotebookEdit operations
- Added optional logging with
--logging
flag - Improved notification filtering to reduce false positives
- Updated default Kokoro voice to af_heart
Installation
uvx ccnotify install
Changelog
Fixed
- NotebookEdit operations no longer trigger false error notifications
- Input needed alerts only appear for actual permission requests
- Empty error fields in tool responses are now properly ignored
- Platform compatibility prompts now respect quiet mode
Added
- Optional logging with
--logging
flag during installation - Debug logging for notification triggers to help troubleshooting
- Keyword filtering for permission-related notifications
Changed
- Error detection logic now checks for non-empty error values
- Notification filtering improved to reduce false positives
- Refactored replacements.json structure to eliminate duplication
- Updated default Kokoro voice to af_heart
PyPI
Package available at: https://pypi.org/project/ccnotify/0.1.13/
v0.1.0 - Voice Notification System for Claude Code
🎉 First Public Release
CCNotify v0.1.0 introduces an intelligent voice notification system for Claude Code with a beautiful single-command installer.
🚀 Quick Start
uvx ccnotify install
That's it! The installer will guide you through everything.
✨ Key Features
🎨 Beautiful Installation Experience
- ANSI Shadow ASCII Art welcome screen with gradient colors
- Single Intelligent Command - one command handles installation, updates, and configuration
- Rich Interactive Interface with progress bars and status displays
- Automatic Detection of existing installations vs first-time setup
🗣️ Advanced TTS Support
- Kokoro Local TTS: 50+ voices, privacy-focused, works offline (~350MB)
- ElevenLabs Cloud TTS: Premium quality, requires API key
- Smart Audio Caching: Prevents regeneration of identical notifications
- Zero Configuration: Works out of the box with sensible defaults
🎯 Intelligent Notifications
- Smart Filtering: Only alerts for significant events, not routine operations
- Project Detection: Automatically identifies your current Claude project
- Risk Awareness: Warns about potentially dangerous commands
- Multi-Event Support: Comprehensive Claude Code hook integration
🔧 Robust Installation Management
- Version Management: Semantic versioning with intelligent update detection
- Backup & Rollback: Safe updates with automatic recovery on failure
- Legacy Migration: Seamlessly migrates from older installations
- Settings Integration: Automatically configures Claude Code with backup
📋 Requirements
- Python 3.9+
- macOS or Linux (Windows not yet supported)
- Claude Code CLI installed
- ~350MB storage for local TTS models (optional)
🏗️ Platform Support
- ✅ macOS: Full support with native notifications and audio
⚠️ Linux: Partial support (notifications working, audio pending)- ❌ Windows: Not yet implemented
📖 Documentation
- Installation Guide: README.md
- Changelog: CHANGELOG.md
- Architecture: docs/
🎁 Included Assets
ccnotify-0.1.0-py3-none-any.whl
- Python wheel for installationccnotify-0.1.0.tar.gz
- Source distribution
🙏 Acknowledgments
Thanks to Kokoro TTS, ElevenLabs, and Rich for making this possible.
Full Changelog: https://github.com/Helmi/ccnotify/blob/main/CHANGELOG.md