If you give your AI agent a longer task and go do something else meanwhile, it can notify you when it has the results or needs your input.

---

settings.local.json for the hook:

{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "afplay /System/Library/Sounds/Funk.aiff"
}
]
}
],
"Notification": [
{
"hooks": [
{
"type": "command",
"command": "afplay /System/Library/Sounds/Purr.aiff"
}
]
}
]
}
}

---

Official Anthropic docs on hooks: docs.anthropic.com/en/docs/claude-code/hooks