Releases: dongzhenye/claude-code-notifications
v0.7.3 - Complete Fix for Remote Installation
🎯 Complete Solution
Comprehensive fix for remote installation input handling.
✅ What Works Now
- Terminal execution: Interactive selection when tty available
- Script execution: Automatic fallback to recommended tier
- CI/CD environments: Non-interactive mode with parameters
- All platforms: macOS, Linux, and Windows
📝 Usage Examples
# Interactive (in terminal)
curl -sSL https://raw.githubusercontent.com/dongzhenye/claude-code-notifications/main/install.sh | bash
# Non-interactive with specific tier
curl -sSL ... | bash -s -- --tier minimal
curl -sSL ... | bash -s -- --tier recommended
# Skip all prompts
curl -sSL ... | bash -s -- --tier recommended -yv0.7.2 - Critical Fix: Remote Installation Input
🚨 Critical Fix
- Fixed remote installation not accepting user input
- Script now properly reads from /dev/tty when piped through curl
- Interactive prompts work correctly in remote mode
🐛 Problem Solved
Previously, the one-liner installation would exit immediately because it couldn't read user input when piped. Now it correctly handles input in all scenarios:
- Local execution: ✅
- Remote execution (curl | bash): ✅
- Non-interactive mode (--tier flag): ✅
📝 Note
Users can now properly select their preferred tier when using:
curl -sSL https://raw.githubusercontent.com/dongzhenye/claude-code-notifications/main/install.sh | bashThe installer will wait for your choice and proceed accordingly.
v0.7.1 - Remote Installation Fix
🐛 Critical Fix
- Fixed one-liner installation command to actually work remotely
- Install script now automatically downloads configurations from GitHub
- No need to clone the repository first
✨ Improvements
- Landing page UI refinements (copy button, layout adjustments)
- Cleaner remote mode detection without verbose output
- Updated documentation to clarify remote installation capability
🚀 Installation
The one-liner now truly works from anywhere:
curl -sSL https://raw.githubusercontent.com/dongzhenye/claude-code-notifications/main/install.sh | bashThis patch ensures the landing page's promise of "one-click installation" is fulfilled.
v0.7.0 - Professional Landing Page
🚀 Major Features
- Professional landing page for Vercel hosting
- SEO optimization with meta tags and Open Graph
- Responsive design for all devices
- Smooth scroll navigation
🎨 Design
- Linear-style minimal aesthetics
- Dark theme with gradient accents
- Interactive tier comparison cards
- Features grid and installation guide
🛠️ Technical
- Static site ready for Vercel deployment
- Clean URLs and security headers
- Optimized performance
- GitHub integration redirects
📦 Deployment
- Ready for
vercel --proddeployment - Configured domain: claude-code-notifications.vercel.app
v0.6.0 - Visual README Redesign
🎨 Visual Improvements
- Professional tier comparison visualization
- Linear-inspired minimal design aesthetic
- Dark theme with gradient effects
- Clear visual hierarchy for better user understanding
📸 Assets
- High-quality tier comparison screenshot
- Optimized for GitHub README display
- Professional typography and spacing
📚 Documentation
- Complete README overhaul with better structure
- Added collapsible sections for cleaner layout
- Improved installation instructions
- Enhanced troubleshooting guides
v0.5.0 - Desktop Notifications & macOS Sequoia Fix
✨ Features
- Improved desktop notification reliability for macOS Sequoia
- Interactive terminal-notifier installation guide
- Dual-track notification strategy (terminal-notifier + osascript fallback)
🐛 Bug Fixes
- Fixed osascript display notification issue on macOS Sequoia
- Better error handling for missing dependencies
📚 Documentation
- Comprehensive README enhancements
- Added troubleshooting guide for macOS notifications
- Updated project memory with technical solutions
🔧 Technical Details
- Detected and worked around macOS Sequoia system-level bug
- Implemented smart dependency checking
- Added user preference persistence for installation choices
v0.4.0 - Unified Installation Script
🚀 Unified Installation Experience
This release introduces a comprehensive installation script that makes setup a breeze.
New Installation Script (install.sh)
Interactive Mode (Default)
./install.sh- Friendly banner with "Never miss a response!" tagline
- Guided tier selection
- Platform auto-detection
- Backup handling for existing configs
CLI Mode (Automation-friendly)
./install.sh -t recommended -y # Quick recommended setup
./install.sh --tier minimal # Minimal tier
./install.sh --tier custom --no-backup # Custom without backupFeatures
- Platform Detection: Automatically detects macOS/Linux/Windows
- Smart Defaults: Recommended tier by default
- Safe Upgrades: Automatic backup with timestamps
- Color Output: Clear visual feedback with color-coded messages
- Validation: Checks for Claude Code installation
- Flexible: Both interactive and scriptable
Installation Flow
- Environment detection
- Tier selection (or use CLI parameter)
- Backup existing config (if any)
- Install appropriate configuration
- Show success summary
Related Issues
- Issue #4: Feature: install.sh - Interactive setup wizard with CLI parameters
Quick Start
# Download and run
curl -sSL https://raw.githubusercontent.com/dongzhenye/claude-code-notifications/main/install.sh | bashThis completes the core functionality for the three-tier notification system. Users can now get started in seconds!
v0.3.0 - Three-Tier Architecture
🏗️ Three-Tier Architecture Implementation
This release introduces a clear three-tier system to match different user needs.
New Architecture
| Tier | Complexity | Setup Time | Best For |
|---|---|---|---|
| Minimal | ⭐ | 5 seconds | Users wanting simplest solution |
| Recommended ⭐ | ⭐⭐ | 30 seconds | Most users (default) |
| Custom | ⭐⭐⭐ | 5+ minutes | Power users with specific needs |
Features Added
Directory Structure
recommended/- Platform-specific configurationsrecommended.macos.jsonrecommended.linux.jsonrecommended.windows.json
custom/- Advanced examplessystem-notify.macos.sh- macOS system notifications
Documentation
- Restructured README with tier-based organization
- Clear tier selection guide at the top
- Platform-specific configurations
Key Decisions (ref #3)
- Naming: Minimal / Recommended / Custom (no hierarchy implied)
- Default: Recommended tier (balanced solution)
- System notifications: Custom tier only (to avoid notification fatigue)
How to Use
Minimal (built-in):
claude config set --global preferredNotifChannel terminal_bellRecommended (copy the appropriate file):
- macOS:
recommended/recommended.macos.json - Linux:
recommended/recommended.linux.json - Windows:
recommended/recommended.windows.json
Custom (see examples):
- Check
custom/directory for examples
This architecture provides progressive enhancement while keeping things simple by default.
v0.2.0 - Product Repositioning
🎯 Major Product Evolution
This release marks the transformation from a sound-only tool to a comprehensive notification solution.
Breaking Changes
- Repository renamed from
claude-code-sound-notificationstoclaude-code-notifications - Expanded scope to support multiple notification types
Key Updates
- New Vision: "Your one-stop solution for Claude Code notifications"
- New Tagline: "Never miss a response!"
- Project Rename: Reflects broader notification capabilities
- Updated README to reflect new positioning
Migration
GitHub automatically redirects old URLs, so existing users are not affected.
Related Discussions
This sets the foundation for supporting visual notifications, webhooks, and other notification channels beyond just sound.
v0.1.0 - Initial Release
🎉 Initial Release
This is the first release of Claude Code Sound Notifications, providing basic audio alerts for Claude Code CLI.
Features
- Simple terminal bell setup with one command
- Advanced hooks configuration for different sounds
- Sound selection guide with recommendations
- Cross-platform examples (macOS, Linux, Windows)
- Quick setup script included
Quick Start
# Simple setup
claude config set --global preferredNotifChannel terminal_bell
# Or use the setup script
./install.shSupported Platforms
- ✅ macOS
- ✅ Linux (ALSA/PulseAudio)
- ✅ Windows (PowerShell)
This release focuses on solving the core problem: never missing Claude Code responses while working in other windows.