config-advanced.md Codex Docs, 2026-04-21 06:45 UTC → 2026-04-21 12:30 UTC

476- `notify` runs an external program (good for webhooks, desktop notifiers, CI hooks).476- `notify` runs an external program (good for webhooks, desktop notifiers, CI hooks).

477- `tui.notifications` is built in to the TUI and can optionally filter by event type (for example, `agent-turn-complete` and `approval-requested`).477- `tui.notifications` is built in to the TUI and can optionally filter by event type (for example, `agent-turn-complete` and `approval-requested`).

478- `tui.notification_method` controls how the TUI emits terminal notifications (`auto`, `osc9`, or `bel`).478- `tui.notification_method` controls how the TUI emits terminal notifications (`auto`, `osc9`, or `bel`).

479- `tui.notification_condition` controls whether TUI notifications fire only when

480 the terminal is `unfocused` or `always`.

479 481 

480In `auto` mode, Codex prefers OSC 9 notifications (a terminal escape sequence some terminals interpret as a desktop notification) and falls back to BEL (`\x07`) otherwise.482In `auto` mode, Codex prefers OSC 9 notifications (a terminal escape sequence some terminals interpret as a desktop notification) and falls back to BEL (`\x07`) otherwise.

481 483 

522 524 

523- `tui.notifications`: enable/disable notifications (or restrict to specific types)525- `tui.notifications`: enable/disable notifications (or restrict to specific types)

524- `tui.notification_method`: choose `auto`, `osc9`, or `bel` for terminal notifications526- `tui.notification_method`: choose `auto`, `osc9`, or `bel` for terminal notifications

527- `tui.notification_condition`: choose `unfocused` or `always` for when

528 notifications fire

525- `tui.animations`: enable/disable ASCII animations and shimmer effects529- `tui.animations`: enable/disable ASCII animations and shimmer effects

526- `tui.alternate_screen`: control alternate screen usage (set to `never` to keep terminal scrollback)530- `tui.alternate_screen`: control alternate screen usage (set to `never` to keep terminal scrollback)

527- `tui.show_tooltips`: show or hide onboarding tooltips on the welcome screen531- `tui.show_tooltips`: show or hide onboarding tooltips on the welcome screen