Skip to content

Releases: dongzhenye/claude-code-notifications

v0.7.3 - Complete Fix for Remote Installation

16 Aug 17:12

Choose a tag to compare

🎯 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 -y

v0.7.2 - Critical Fix: Remote Installation Input

16 Aug 17:04

Choose a tag to compare

🚨 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 | bash

The installer will wait for your choice and proceed accordingly.

v0.7.1 - Remote Installation Fix

16 Aug 16:58

Choose a tag to compare

🐛 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 | bash

This patch ensures the landing page's promise of "one-click installation" is fulfilled.

v0.7.0 - Professional Landing Page

16 Aug 16:19

Choose a tag to compare

🚀 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 --prod deployment
  • Configured domain: claude-code-notifications.vercel.app

v0.6.0 - Visual README Redesign

16 Aug 16:17

Choose a tag to compare

🎨 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

16 Aug 16:17

Choose a tag to compare

✨ 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

16 Aug 05:16

Choose a tag to compare

🚀 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 backup

Features

  • 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

  1. Environment detection
  2. Tier selection (or use CLI parameter)
  3. Backup existing config (if any)
  4. Install appropriate configuration
  5. 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 | bash

This completes the core functionality for the three-tier notification system. Users can now get started in seconds!

v0.3.0 - Three-Tier Architecture

16 Aug 05:14

Choose a tag to compare

🏗️ 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 configurations
    • recommended.macos.json
    • recommended.linux.json
    • recommended.windows.json
  • custom/ - Advanced examples
    • system-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_bell

Recommended (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

16 Aug 05:13

Choose a tag to compare

🎯 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-notifications to claude-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

  • Issue #2: Expanding project scope
  • Issue #3: Three-tier architecture RFC

This sets the foundation for supporting visual notifications, webhooks, and other notification channels beyond just sound.

v0.1.0 - Initial Release

16 Aug 05:10

Choose a tag to compare

🎉 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.sh

Supported 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.