Skip to content

Fishason/claude-notify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Notify

Get push notifications on your iPhone when Claude Code finishes a task.

Built for SSH workflows — know when Claude is done without watching the terminal.

Notification banner

Notification list

Setup

1. Install Bark on your iPhone (free)

2. Install the CLI

npm install -g @fishason/cc-notify

3. Initialize

claude-notify init

Scan the QR code with your phone, paste your Bark key on the binding page.

4. Enable the hook

claude-notify setup-hook

Done. You'll get a push notification whenever Claude Code is idle and waiting for input.

Commands

claude-notify init          Register device, show QR code
claude-notify init --force  Re-register (new QR code)
claude-notify test          Send a test notification
claude-notify status        Check binding status
claude-notify setup-hook    Configure Claude Code hook
claude-notify pause         Pause notifications
claude-notify resume        Resume notifications

How it works

Claude Code finishes → idle 60s → Hook fires → Cloudflare Worker → Bark → iPhone

Notifications show the session name (set via /rename in Claude Code) or the project directory.

Mac notifications

iPhone notifications sync to Mac via iPhone Mirroring (macOS Sequoia + iOS 18) or notification forwarding with the same Apple ID.

Requirements

  • Node.js >= 18
  • iPhone with Bark app

License

MIT

About

Push notifications to iPhone when Claude Code finishes on SSH servers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors