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

  1. 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
  1. 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: afplay or 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.

View original on GitHub ↗

This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗