v0.3.0 - Remote SSH & Mobile Development Support

🌐 Remote SSH & Mobile Development Support

Version 0.3.0 introduces comprehensive support for remote development workflows, enabling seamless desktop-to-mobile handoff for Claude Code sessions.

✨ New Features

Remote Mode (SSH/mosh)

• Auto-detection - Automatically detects SSH sessions via SSH_CONNECTION environment variable
• Intelligent idle detection - Uses TTY access time (st_atime) for accurate remote activity tracking
• Push-only notifications - Skips local notifications in remote mode, uses Pushover exclusively
• Custom push URLs - Configure CC_NOTIFIER_PUSH_URL with placeholders for session resumption

Mobile Development Workflow

• Blink Shell integration - Tap push notifications to auto-resume sessions in Blink Shell
• URL scheme support - Custom URLs enable seamless mobile handoff
• Mobile scripts - mosh-cc-resume.sh and tmux-idle-cleanup.sh for session management
• Tested stack - Full compatibility with Tailscale + mosh + tmux + Blink Shell

📖 Documentation

• Comprehensive mobile development guide with setup instructions
• Improved README organization and clarity
• Remote stack documentation
• Configuration examples for both desktop and remote modes

🔧 Technical Improvements

• TTY-based idle detection for remote sessions
• Placeholder substitution in push URLs ({session_id}, {cwd})
• Environment-specific notification logic (desktop vs remote)
• Session persistence with tmux integration

📱 Mobile Setup

See the mobile workflow documentation for complete setup instructions.

🔗 Links

• Tested with: Tailscale + mosh + tmux + Blink Shell
• Full documentation: README.md

---

Full Changelog: v0.2.0...v0.3.0

v0.2.0

What's New

• 📲 Push Notifications: Intelligent push notifications when you're away from your computer (optional Pushover integration)
• ⏱️ Improved Idle Detection: Progressive check intervals (3s, 20s) for better user experience
• 🐍 Python Migration: Complete rewrite from bash to Python with modern tooling and improved maintainability
• 📚 Enhanced Documentation: Updated context files and documentation for Python migration
• 🐛 Bug Fixes:
  • Fixed manual testing compatibility with cc_notifier.py
  • Prevented direct execution in Claude Code hooks for non-blocking behavior
  • Updated uninstall script for Python migration compatibility

Upgrading from v0.1.0-alpha

IMPORTANT: v0.1.0-alpha installed to ~/.local/bin. v0.2.0 uses ~/.cc-notifier/.

To upgrade cleanly:

1. Uninstall old version first:

   cd cc-notifier
   git checkout v0.1.0-alpha
   ./uninstall.sh

2. Install new version:

   git checkout main
   git pull
   ./install.sh

3. Update Claude Code settings (~/.claude/settings.json):

   • Change hook paths from ~/.local/bin/cc-notifier to ~/.cc-notifier/cc-notifier
   • (Optional) Add Pushover credentials for push notifications

Full Changelog

Commits since v0.1.0-alpha:

• fix: adjust idle check intervals and clarify fix command behavior (d71b263)
• fix: resolve manual_testing.py compatibility issues with cc_notifier.py (eb4ce5c)
• fix: prevent direct execution in Claude Code hooks (3a315c3)
• fix: update uninstall script for python migration compatibility (cd4690c)
• docs: enhance documentation and context files for python migration (e6790fb)
• feat: add comprehensive testing framework and manual testing utilities (32af81f)
• feat: migrate from bash to python with modern tooling infrastructure (cc86e63)
• feat: Add version flag and improve error handling (cda1b97)
• refactor: Move away from ~/.local/bin to single directory installation (b01f2c1)
• docs: Clean up repository structure and update README (e42ed12)
• docs: Add troubleshooting section for window focus issues (2c3453f)

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!