코덱스 CLI 작업이 끝나면 터미널 알림 받는 설정법

코덱스(Codex) CLI는 턴이 끝났을 때나 승인을 기다릴 때 터미널 알림을 보낸다. config.toml의 [tui] 아래 세 줄로 켠다.

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

• notifications는 true로 모두 켜거나, 받을 이벤트만 배열로 적는다.
• notification_method는 auto·osc9·bel 가운데 하나다. 기본값 auto는 OSC 9 알림을 먼저 쓰고, 터미널이 못 받으면 BEL(\x07)로 넘어간다.
• notification_condition은 기본값이 unfocused라 터미널을 보고 있을 땐 알림이 오지 않는다. 늘 받으려면 always로 바꾼다.

11월 13일 나온 0.168.0부터는 notification_method에 "osc777"도 넣을 수 있다. 승인 알림은 명령 미리보기가 길어졌고, 터미널 입력을 묻는 알림과 네트워크 접근을 묻는 알림이 따로 표시된다.

npm install -g @openai/codex@0.168.0

슬랙 웹훅이나 macOS 알림 도구로 받으려면 설정 파일 맨 위에 notify를 두고 외부 프로그램을 건다. 지금 넘어오는 이벤트는 agent-turn-complete 하나뿐이다.

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