Feature Request: Audio notifications for permission prompts and task completion

Status Closed — not planned
Maintainer reply None cached
Activity 7 comments · opened Dec 30, 2025 · 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 ↗