Simple built-in sound toggle for interactive turn completion
What variant of Codex are you using?
CLI (macOS)
What feature would you like to see?
Please add a simple built-in sound toggle for interactive mode when an assistant turn is completed.
This is a UX request, not a bug report.
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
Codex CLI already supports notification commands, and I currently use:
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 a simple built-in sound setting.
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, cross-platform 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 with no custom shell command required.
Environment
- Codex CLI:
0.104.0 - Platform: macOS (arm64)
Additional information
_No response_
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗