Feature Request: Audio notifications for permission prompts and task completion
Resolved 💬 7 comments Opened Dec 30, 2025 by goushuai888 Closed Mar 14, 2026
Feature Request
Description
Add audio notification support to improve user experience when running long tasks or when attention is needed.
Proposed Features
- Permission Request Sound
- Play a notification sound when Claude Code requests user permission
- Helps users notice permission prompts when they're working on other things
- Task Completion Sound
- Play a notification sound when a task/command completes
- Especially useful for long-running operations (builds, tests, deployments)
Use Cases
- Running long builds while working on other tasks
- Waiting for permission prompts during automated workflows
- Multi-tasking scenarios where the terminal isn't always visible
Suggested Implementation
- Add configuration options in
settings.json:
``json``
{
"notifications": {
"sound": {
"enabled": true,
"onPermissionRequest": true,
"onTaskComplete": true,
"soundFile": "default"
}
}
}
- Could use system sounds or allow custom sound files
- Optional: Different sounds for different events
Platform Consideration
- macOS:
afplayor system sounds - Linux:
paplay,aplay, or similar - Windows: PowerShell audio commands
Would love to see this feature! It would significantly improve the workflow when running Claude Code for extended periods.
This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗