Sound notifications for turn completion and user input required
Resolved 💬 2 comments Opened Jan 22, 2026 by Lazyb0y Closed Jan 22, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor)
responded on this thread — see the highlighted reply below.
What feature would you like to see?
When running long-running prompts, users may switch to other tasks and miss when the prompt completes or requires input. Currently, there is no audible alert.
Proposed Solution
Add optional sound notifications that play:
- When a turn completes
- When user input is required
Configuration
Extend the existing [tui] config section to support sound:
[tui]
# Existing notification options
notifications = true
# New sound options (proposed)
sound_on_complete = true # Play sound when turn completes
sound_on_input_required = true # Play sound when input is needed
For custom sounds, users could specify a command:
[tui]
sound_on_complete = ["afplay", "/System/Library/Sounds/Glass.aiff"]
sound_on_input_required = ["afplay", "/System/Library/Sounds/Ping.aiff"]
Implementation Approach
- Use terminal bell (
\x07) as the default cross-platform sound - Support custom sound commands (similar to the existing
notifications = ["command"]pattern) - Follow the existing notification backend pattern in
tui/src/notifications/
Why This Matters
- Improves productivity by alerting users to completed tasks
- Prevents missed approval requests that could block progress
- Follows existing patterns in the codebase (mirrors the
Notificationsenum design)
Additional information
_No response_
2 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Thanks for the suggestion. We're tracking this in #3962. Please upvote that issue if you'd like to see this feature implemented.