Built-in sound notification for interactive turn completion
Resolved 💬 3 comments Opened Feb 22, 2026 by mark0011astra Closed Apr 3, 2026
What variant of Codex are you using?
CLI
What feature would you like to see?
Summary
Please add a first-class, built-in sound notification for interactive mode when an assistant turn is completed.
Motivation
In interactive Codex sessions, users often switch to other windows while waiting for responses.
A completion sound improves workflow and reduces idle checking.
Current workaround
I currently use config-based command notifications:
notify = ["sh", "-lc", "afplay /System/Library/Sounds/Glass.aiff >/dev/null 2>&1 || printf '\\a'"]
[tui]
notifications = ["agent-turn-complete"]
This works, but it is not ideal.
Problems with the workaround
- Platform-specific (
afplayis macOS-specific). - Requires shell command knowledge.
- Easy to misconfigure.
- Not obvious to discover for new users.
- No unified built-in UX across macOS/Linux/Windows.
Proposed solution
Add a native option for sound-on-completion in interactive mode, for example:
- CLI flag:
--sound-on-turn-complete - Config option:
[tui] sound_on_turn_complete = true
Optional extension:
- configurable sound profile/path
- fallback to terminal bell when native sound is unavailable
Expected behavior
When agent-turn-complete occurs in interactive mode, Codex plays one notification sound.
Environment
- Codex CLI:
0.104.0 - Platform: macOS (arm64)
Additional information
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗