cc-notifier

🥈Silver

cc-notifier sends smart macOS and push notifications for Claude Code. Developers get instant access to their exact terminal or IDE window across macOS Spaces. Also supports mobile development via push notifications.

9420Updated 2mo ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

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

Works with:

Claude

Overview

About This Skill

cc-notifier bridges your Claude Code sessions across desktop and mobile by sending intelligent notifications that restore your exact window, tab, and workspace context. On desktop, it detects when you switch windows or iTerm2 tabs and sends a local notification; clicking it restores your original Claude Code context across macOS Spaces. For remote SSH workflows, it monitors idle time and sends push notifications via Pushover, enabling seamless mobile development through Blink Shell integration. The tool runs asynchronously in the background without blocking Claude Code, supports debug logging for troubleshooting, and integrates via hooks in Claude's settings.json configuration file.

How to Use

Install Hammerspoon and terminal-notifier via Homebrew, clone cc-notifier from GitHub, run the install script, then add the provided hooks to ~/.claude/settings.json for SessionStart, Stop, Notification, and SessionEnd events. Optionally configure Pushover credentials in the env section for push notifications. Enable debug mode by adding --debug flags to hook commands for troubleshooting.

Use Cases

Restore Claude Code window context instantly when returning from other apps

Resume exact iTerm2 tab and session after switching between multiple terminals

Get push notifications on your phone when Claude Code tasks complete while you're away

Automate session resumption on mobile via Blink Shell for remote development

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

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

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I'm using cc-notifier to manage my development workflow. I need to set up notifications for [PROJECT_NAME], a [PROGRAMMING_LANGUAGE] project in [IDE_NAME]. Please provide the configuration steps and any best practices for this setup.

Example Output

# cc-notifier Configuration for Project Setup

## Project Details
- **Project Name**: Quantum Leap
- **Language**: Python
- **IDE**: Visual Studio Code

## Notification Settings
- **Terminal Notifications**: Enabled
- **IDE Notifications**: Enabled
- **Push Notifications**: Enabled for mobile
- **Priority Level**: High for critical errors

## Best Practices
- Use descriptive project names for easy identification.
- Enable push notifications for mobile development to stay updated on the go.
- Configure priority levels to manage notification overload.

## Example Command
```bash
cc-notifier configure --project QuantumLeap --language Python --ide VSCode --terminal true --ide true --push true --priority high
```