Never miss when Claude needs you

Sound alerts, native notifications, and seamless file transfer between your local machine and remote Claude Code sessions — all over an SSH tunnel.

macOS

v26.01

Native Swift or Go/Wails

.dmg (Swift) .dmg (Go/Wails)

Linux

v26.01

Debian/Ubuntu & generic

.deb (amd64) .tar.gz (amd64)

Windows

v26.01

Installer or portable

.exe (Installer) .zip (Portable)
Releases

How It Works

Remote Server

Claude Code runs your task
Hooks fire on events
POST /notify & GET /file
SSH Reverse
Tunnel :5775

Your Machine

Sound alert plays
Notification banner appears
Local files served on demand
Features

Everything you need to stay in the loop

Sound Alerts

Configurable sounds for every event type — stop, question, permission prompt, and more. Multiple sound packs with per-event volume and random selection.

Native Notifications

macOS notification banners showing the project name and event context — see the question Claude is asking without switching windows.

File Transfer

Paste a local file path into your remote Claude prompt and ClipNotify fetches it automatically. Screenshots, documents, images — all seamless.

Per-Project Settings

Each project gets its own sound pack, notification toggle, and file transfer settings. Projects are auto-discovered from incoming events.

Sound Pack Repository

Browse and install community sound packs from online repositories. Export and share your own packs as zip files.

Secure by Default

IP whitelist restricts connections to localhost. File access uses extension and folder whitelists. Optional auth token for the HTTP API.

Works with Claude Code Remote Control

ClipNotify is fully compatible with Remote Control — continue your session from your phone or another browser while ClipNotify keeps sending sound alerts and notifications to your machine.

Cross-Platform

Runs where you do

macOS

Native Swift & Go/Wails

Native menu bar app built with Swift and AppKit. Zero dependencies. Also available as a Go/Wails cross-platform build.

Linux

Go/Wails · .deb & .tar.gz

System tray, ALSA sound, desktop notifications. Works on KDE, XFCE, Cinnamon, GNOME (with extension), and more.

Windows

Go/Wails · Installer & Portable

Full-featured Windows build with installer or portable zip. System tray integration and native notifications.

Get Started

Up and running in 3 steps

1

Install the app

  • Download a release — grab the latest build from Releases (.dmg, .deb, .exe, or .zip)
  • Homebrew (macOS)
    # Add the tap brew tap clipnotify/homebrew https://github.com/clipnotify/homebrew-clipnotify.git # Install (native Swift menu bar app) brew install --cask clipnotify # Or install the Go/Wails cross-platform build brew install --cask clipnotify-cross
  • APT (Debian/Ubuntu)
    # Add the GPG signing key curl -fsSL https://apt.clipnotify.com/key.gpg \ | sudo gpg --dearmor -o /usr/share/keyrings/clipnotify.gpg # Add the repository to your sources echo "deb [signed-by=/usr/share/keyrings/clipnotify.gpg] \ https://apt.clipnotify.com/ stable main" \ | sudo tee /etc/apt/sources.list.d/clipnotify.list # Install sudo apt update && sudo apt install clipnotify
  • Build from source
    # macOS (native Swift app) cd app-osx && make install # Linux / Windows (Go/Wails) cd app-cross && make build
2

Deploy the hook to your remote server

  • From the app — open Settings, enter user@hostname and click Deploy
  • Command line
    cd remote-hook && ./deploy.sh user@your-server
3

Connect with an SSH reverse tunnel

That's it — now every Claude Code event on the server triggers a sound and notification on your machine.

  • Automatic — the deployment script updates your SSH config with the reverse tunnel setting
    # ~/.ssh/config Host your-server HostName your-server.example.com User your-user RemoteForward 5775 localhost:5775
  • Manual — connect with the reverse tunnel flag directly
    ssh -R 5775:localhost:5775 your-server