[FEATURE] Feature Request: Sound Notifications for User Input and Task Completion

Resolved 💬 3 comments Opened Feb 25, 2026 by adevuyst Closed Feb 28, 2026

Preflight Checklist

  • [x] I have searched existing requests and this feature hasn't been requested yet
  • [x] This is a single feature request (not multiple features)

Problem Statement

## Feature Request

Description:
Add configurable sound notifications to Claude Code to alert users when:

  1. Claude needs user input (e.g., after AskUserQuestion tool calls)
  2. A task or operation completes

Benefits:

  • Improved developer experience for long-running operations
  • Reduced context switching
  • Better awareness of when Claude needs input

Proposed Solution

Proposed Implementation:

  • Add sound settings to ~/.claude/settings.json:

```json
{
"sounds": {
"enabled": true,
"onUserInputRequired": true,
"onTaskComplete": true,
"customSoundPath": "/path/to/custom.mp3"
}
}

  • Use system sounds by default (macOS: afplay, Linux: aplay, Windows: powershell -c)
  • Allow custom sound files
  • Respect system Do Not Disturb settings

Alternative Solutions

_No response_

Priority

Medium - Would be very helpful

Feature Category

Configuration and settings

Use Case Example

Use Case:
When working on longer tasks or background operations, users often switch to other applications. Sound notifications would help users know when their attention is needed without
constantly monitoring the terminal.

Additional Context

_No response_

View original on GitHub ↗

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