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

View original on GitHub ↗

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