How to get terminal notifications when a Codex CLI turn finishes

Codex CLI can send a terminal notification when a turn finishes or when it is waiting for approval. Turn it on with three keys under [tui] in config.toml.

[tui]
notifications = ["agent-turn-complete", "approval-requested"]
notification_method = "auto"
notification_condition = "unfocused"

• notifications takes true to enable everything, or an array of the event types you want.
• notification_method is one of auto, osc9 or bel. The default auto prefers OSC 9 notifications and falls back to BEL (\x07) otherwise.
• notification_condition defaults to unfocused, so nothing fires while you are looking at the terminal. Set it to always to get them regardless of focus.

Since 0.168.0 (November 13), notification_method also accepts "osc777". Approval notifications now show longer command previews and distinguish terminal input from network access requests.

npm install -g @openai/codex@0.168.0

To route alerts to a Slack webhook or a macOS notifier instead, point the top-level notify key at an external program. Right now the only event it receives is agent-turn-complete.

notify = ["python3", "/path/to/notify.py"]