Skip to content

v0.1.0 - Voice Notification System for Claude Code

Choose a tag to compare

View all tags
@Helmi Helmi released this 03 Aug 12:24
· 51 commits to main since this release
v0.1.0
e9a507a

🎉 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

🎁 Included Assets

  • ccnotify-0.1.0-py3-none-any.whl - Python wheel for installation
  • ccnotify-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

Assets 4
Loading