claude-ping-me

claude-ping-me

You tell Claude what to do. You go scroll Instagram. Claude pings you when it's done.

That's it. That's the plugin.

---

If you're a vibe coder — someone who gives Claude a task, switches to another tab, and mindlessly scrolls until something happens — this is for you. No more checking back every 30 seconds. No more finding out Claude has been waiting for your approval for 10 minutes while you were watching reels.

Claude Code plays a sound when:

• It finishes a response and is waiting for your next prompt
• It's been idle and needs your input (approve a plan, pick an approach, etc.)

You hear the ping. You come back. You vibe.

Install

One-liner (recommended)

npx skills add nerdynikhil/claude-ping-me -g -y

That's it. Works with Claude Code, Cursor, Copilot, Windsurf, Cline, and 30+ other agents.

Manual setup

If you prefer doing it yourself:

1. Clone it:

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

2. Add the hooks to your ~/.claude/settings.json:

   {
     "hooks": {
       "Notification": [
         {
           "matcher": "idle_prompt",
           "hooks": [
             {
               "type": "command",
               "command": "bash $HOME/.agents/skills/claude-ping-me/hooks/play-sound.sh"
             }
           ]
         }
       ],
       "Stop": [
         {
           "matcher": "",
           "hooks": [
             {
               "type": "command",
               "command": "bash $HOME/.agents/skills/claude-ping-me/hooks/play-sound.sh"
             }
           ]
         }
       ]
     }
   }
   

   If you installed via npx skills add, the path above works as-is. If you cloned manually, replace with your actual path.

   If you already have stuff in your settings file, just merge the hooks key in — don't overwrite.

3. Restart Claude Code. Done.

Platform support

OS	Player	Dependencies
macOS	afplay	None (built-in)
Linux	mpg123 / ffplay / paplay	sudo apt install mpg123
Windows	PowerShell MediaPlayer	None

Want a different sound?

Swap out sounds/ping.mp3 with whatever you want. Keep the filename or update hooks/play-sound.sh.

How it works under the hood

Claude Code has a hooks system. We hook into two events:

• Notification (matcher: idle_prompt) — fires when Claude has been idle and needs your attention
• Stop — fires when Claude finishes responding

Both run play-sound.sh, which detects your OS and plays sounds/ping.mp3 with the right audio player.

License

MIT