ccnotifs

Native macOS notifications for Claude Code. Know when Claude finishes or needs your input. Approve or reject Claude Code's permission prompts directly from a notification, OR click the notification to bring into focus the terminal window/tmux pane running the Claude Code process.


Features

• One-tap approve — Approve permission prompts directly from the notification
• Two notification types — "Done" when Claude finishes, "Needs Input" when Claude needs approval
• Command preview — Shows the tool name and command in the notification body
• Teleport — Click a notification to teleport back to the right terminal, tmux session, window, and pane
• tmux context — Shows session name, window number, and window name
• Project name — Displays the current project directory
• Suppression — Skips notifications when you're already viewing the Claude Code session
• Custom icon — Use your own app icon instead of the default Script Editor icon
• Sound — Plays a sound per notification type

Quick Start

brew install jq
brew install vjeantet/tap/alerter

curl -fsSL https://raw.githubusercontent.com/polyphilz/ccnotifs/main/install.sh | bash

The bootstrap installer resolves the latest GitHub release by default.

• Pin a release: `curl -fsSL https://raw.githubusercontent.com/polyphilz/ccnotifs/main/install.sh | CCN