v0.1.0-alpha: Initial Alpha Release

cc-notifier v0.1.0-alpha

Initial alpha release of cc-notifier - intelligent macOS notifications for Claude Code with cross-space window focusing.

🎯 Key Features

• Cross-Space Window Focusing: Returns focus to the exact window where Claude Code was running, even across macOS Mission Control Spaces
• Intelligent Notifications: Only notifies when you've actually switched away from the original window
• Click-to-Focus: Click the notification to instantly return to your work
• Standard Unix Installation: Installs to ~/.local/bin and ~/.local/share
• Automatic Hook Configuration: Generates ready-to-use Claude Code hook configuration

🔧 Requirements

• Hammerspoon - For cross-space window management
• terminal-notifier - For macOS notifications with click actions
• jq - For parsing Claude Code hook data

📦 Installation

git clone https://github.com/Rendann/cc-notifier.git
cd cc-notifier
./install.sh

Follow the installer prompts to add the generated hook configuration to your ~/.claude/settings.json.

🧪 Alpha Status

This is an alpha release for community testing. Please report issues and feedback!

📚 Technical Background

See docs/RESEARCH_LOG.md for the technical challenges solved, including cross-space window detection and macOS automation limitations.

🤝 Feedback Welcome

This project solves real technical challenges with macOS window management. If you try it out, please share your experience!