{"slug": "i-made-claude-code-ding-when-it-s-done-and-it-changed-my-workflow", "title": "I Made Claude Code Ding When It's Done (And It Changed My Workflow)", "summary": "A developer building jo4.io configured Claude Code's Stop hook to play a macOS system sound when the AI assistant finishes a task or requires input, eliminating the need to constantly monitor the terminal. The simple hook, added to ~/.claude/settings.json, plays the Funk.aiff sound via afplay, and can be extended to play different sounds based on task success or failure. The developer reports that this feedback loop cut average task turnaround in half by removing the human bottleneck.", "body_md": "This article was originally published on[Jo4 Blog].\n\nYou know that feeling when you ask Claude Code to refactor a module, switch to Twitter for \"just a sec,\" and come back 12 minutes later to find it's been sitting there waiting for your input for the last 11?\n\nYeah. That was my Friday evening.\n\nI've been using Claude Code as my daily driver while building [jo4.io](https://jo4.io). It's brilliant at crunching through multi-file refactors, running tests, and fixing bugs. But here's the thing - when Claude finishes a task or has a question, it just... sits there. Silently. Like a polite intern who finished their work but doesn't want to interrupt your YouTube rabbit hole.\n\nI needed a way for Claude to tap me on the shoulder. Something that says \"Hey, I'm done\" or \"Hey, I need you\" without me obsessively watching the terminal.\n\nClaude Code has a hook system. I already wrote about [PreToolUse hooks](https://blog.jo4.io/claude-code-hooks/) for blocking dangerous git commands. Turns out there's a `Stop`\n\nhook that fires every time Claude finishes responding and hands control back to you.\n\nHere's the entire config I added to `~/.claude/settings.json`\n\n:\n\n```\n{\n  \"hooks\": {\n    \"Stop\": [\n      {\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"afplay /System/Library/Sounds/Funk.aiff\",\n            \"timeout\": 5\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\nThat's it. That's the whole thing.\n\nEvery time Claude Code:\n\n...my Mac plays the **Funk** sound. You know the one - that satisfying little `bonk`\n\nthat macOS has shipped since forever.\n\nBefore this, my workflow looked like:\n\n```\n1. Give Claude a task\n2. Switch to browser\n3. Forget about Claude\n4. Come back 15 minutes later\n5. Realize it's been waiting for 14 of those minutes\n6. Feel guilty\n7. Repeat\n```\n\nNow it's:\n\n```\n1. Give Claude a task\n2. Switch to browser / grab coffee / stretch\n3. *bonk*\n4. Switch back immediately\n5. Continue where we left off\n```\n\nMy feedback loop went from \"whenever I remember to check\" to **instant**. I'm not exaggerating when I say this cut my average task turnaround in half - not because Claude got faster, but because *I* stopped being the bottleneck.\n\nmacOS ships with a bunch of system sounds. Want something different? Try these:\n\n```\n# List all available system sounds\nls /System/Library/Sounds/\n\n# Some favorites:\nafplay /System/Library/Sounds/Glass.aiff    # Subtle, clean\nafplay /System/Library/Sounds/Ping.aiff     # Classic notification\nafplay /System/Library/Sounds/Hero.aiff     # Triumphant finish\nafplay /System/Library/Sounds/Purr.aiff     # Gentle nudge\nafplay /System/Library/Sounds/Funk.aiff     # The OG (my pick)\n```\n\nOn Linux, you could use `paplay`\n\n, `aplay`\n\n, or even `espeak \"done\"`\n\nif you want Claude to literally tell you it's finished. On Windows WSL, `powershell.exe -c \"(New-Object Media.SoundPlayer 'C:\\Windows\\Media\\notify.wav').PlaySync()\"`\n\nworks.\n\nWant different sounds for different situations? The Stop hook receives JSON on stdin with a `last_assistant_message`\n\nfield. You could parse that to play a success sound when tests pass and an error sound when something breaks:\n\n``` bash\n#!/bin/bash\ninput=$(cat)\nmessage=$(echo \"$input\" | jq -r '.last_assistant_message // empty')\n\nif echo \"$message\" | grep -qi \"error\\|fail\\|blocked\"; then\n  afplay /System/Library/Sounds/Basso.aiff\nelse\n  afplay /System/Library/Sounds/Funk.aiff\nfi\n```\n\nSave that as `~/.claude/stop-sound.sh`\n\n, make it executable, and point your hook at it instead.\n\nCombined with the [PreToolUse hooks](https://blog.jo4.io/claude-code-hooks/) I set up earlier, my `~/.claude/settings.json`\n\nnow looks like:\n\n```\n{\n  \"hooks\": {\n    \"Stop\": [\n      {\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"afplay /System/Library/Sounds/Funk.aiff\",\n            \"timeout\": 5\n          }\n        ]\n      }\n    ],\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"Bash\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"~/.claude/block-git.sh\",\n            \"timeout\": 10\n          },\n          {\n            \"type\": \"command\",\n            \"command\": \"~/.claude/block-cd.sh\",\n            \"timeout\": 10\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\nPreToolUse hooks keep Claude safe. Stop hooks keep *me* in the loop. Together they make Claude Code feel less like a tool and more like a teammate who knows when to wait and when to nudge.\n\nThese are the little things that make your day as a nerdy engineer. A five-line config change, a system sound you've heard a thousand times, and suddenly your entire AI-assisted workflow just *clicks*. It's not a groundbreaking feature. It's not going to make the front page of Hacker News. But it'll save you dozens of context-switch minutes every single day, and you'll wonder why you didn't set it up sooner.\n\n**Have you set up Stop hooks yet? What sound did you pick?** Drop a comment - I'm genuinely curious what sounds people gravitate toward. Bonus points if you went the `espeak`\n\nroute and have Claude literally talking to you.\n\n*Building jo4.io - a modern URL shortener with analytics, bio pages, and team workspaces.*", "url": "https://wpnews.pro/news/i-made-claude-code-ding-when-it-s-done-and-it-changed-my-workflow", "canonical_source": "https://dev.to/anand_rathnas_d5b608cc3de/i-made-claude-code-ding-when-its-done-and-it-changed-my-workflow-5e35", "published_at": "2026-06-28 01:49:39+00:00", "updated_at": "2026-06-28 02:03:27.921874+00:00", "lang": "en", "topics": ["developer-tools", "large-language-models", "ai-agents"], "entities": ["Claude Code", "jo4.io", "macOS", "Funk.aiff", "afplay", "Basso.aiff", "Glass.aiff", "Ping.aiff"], "alternates": {"html": "https://wpnews.pro/news/i-made-claude-code-ding-when-it-s-done-and-it-changed-my-workflow", "markdown": "https://wpnews.pro/news/i-made-claude-code-ding-when-it-s-done-and-it-changed-my-workflow.md", "text": "https://wpnews.pro/news/i-made-claude-code-ding-when-it-s-done-and-it-changed-my-workflow.txt", "jsonld": "https://wpnews.pro/news/i-made-claude-code-ding-when-it-s-done-and-it-changed-my-workflow.jsonld"}}