claude-ping-me

Play a notification chime when Claude Code goes idle and is waiting for user input. Never miss a prompt again.

When to use

Use this skill when you want audible notifications from Claude Code. It hooks into the Notification event with the idle_prompt matcher so a sound plays whenever Claude is waiting for you — useful if you step away from the terminal.

Instructions

1. Clone the repo:

   git clone https://github.com/nerdynikhil/claude-ping-me.git ~/claude-ping-me
   

2. Add the hook to your Claude Code settings (~/.claude/settings.json):

   {
     "hooks": {
       "Notification": [
         {
           "matcher": "idle_prompt",
           "hooks": [
             {
               "type": "command",
               "command": "bash ~/claude-ping-me/hooks/play-sound.sh"
             }
           ]
         }
       ]
     }
   }
   

3. Restart Claude Code. You’ll hear a ping whenever Claude is idle and waiting for input.

Customization

Replace sounds/ping.mp3 with any MP3 file to use your own notification sound.

Platform support

• macOS — uses built-in afplay (no dependencies)
• Linux — uses mpg123, ffplay, or paplay
• Windows — uses PowerShell MediaPlayer