PourNotify now focuses on when Codex stops and needs your attention.
Supported attention notifications
- Finished: a supported user-facing task stops after producing its result.
- Input Required: a task stops because required owner information is missing, including validated English and Chinese blocking-input requests.
- Short notifications use
Codex Needs Attention · <project>with a brief reason, rather than copying full responses.
Reliability and privacy
- Normal external notify and the conservative Windows local fallback observer share classification and thread/turn deduplication.
- Startup baselining prevents historical-task replay.
- Internal subagents, activity summaries, title/description/UI metadata, intermediate progress, validation/control turns and unknown sources remain suppressed.
- Diagnostics retain safe lifecycle metadata without unnecessarily duplicating private prompts or full answers.
- Existing configuration remains compatible; explicit saved preferences are preserved.
Important limitations
Real Codex Desktop Approval Required detection is not reliably supported or validated. The compatibility category remains available but is disabled by default for new configurations. No heuristic approval detection has been added.
Codex exposes turn-level notify events rather than an explicit task-terminal lifecycle signal. Classification remains conservative and depends on supported local state representations; this release does not claim perfect task-final detection.
Validation
The v1.0.6 tag CI passed on both Windows and macOS, including tests, Ruff and packaging.
Ruff, 301 pytest tests and a clean Windows PyInstaller build passed. Final-build real Finished and Input Required cases each produced one technical dispatch and one History entry; the owner confirmed Sound 1 / Windows 1 / Bark 1 for each. No duplicates, false positives or false negatives were observed in those two supported final-build cases. These results do not imply Approval Required support.