Skip to content

hookWorkflow

Notification Bell

Beeps in your terminal whenever Claude Code asks for permission or waits on you, so an agent that is blocked never sits unnoticed.

npx workspacetemplates add notification-bell --tool claude-code

Writes 1 file to .claude/

.claude/settings.jsonmerge into your file15 lines · 493 BFile
{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node -e \"let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{let j={};try{j=JSON.parse(d)}catch(e){}const B=String.fromCharCode(7);const w=process.platform==='win32';try{require('fs').writeFileSync(w?'CON':'/dev/tty',B)}catch(e){try{process.stderr.write(B)}catch(x){}}process.exit(0)})\"",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

What it does

An agent that waits for a yes can sit idle for an hour. This Notification hook fires whenever Claude Code raises an alert, such as a permission request or a long idle wait, and sounds the terminal bell.

The bell character goes to the terminal device itself, with standard error as a fallback. It does not read the alert text and it never blocks anything.

Example

you › Update the lockfile and run the build.

agent › Claude asks to run a shell command, the terminal beeps, and you approve it from the other window.

Questions

How is this different from the Stop bell?
It sounds when Claude needs you, not when it is done. Use both if you want a sound for each.
Can I limit it to permission prompts?
Yes. Add a matcher such as permission_prompt to the hook entry in your settings.
  • Inject Current Date

    HookWorkflow

    Free
  • Log Bash Commands

    HookWorkflow

    Free
  • Log Session End

    HookWorkflow

    Free