Simple built-in sound toggle for interactive turn completion

Resolved 💬 1 comment Opened Feb 22, 2026 by mark0011astra Closed Feb 22, 2026

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 (afplay is 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_

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗