Codex App: Add configurable macOS Dock badge count for completed local tasks/turns
What variant of Codex are you using?
App 26.623.141536
What feature would you like to see?
I would like the macOS Codex desktop app to optionally show a Dock badge count when local Codex tasks or turns complete.
Current behavior:
Codex can send notifications via the notify hook, and the macOS app already appears to support Dock badge counts for some cloud/unread states. However, local task completion does not appear to have a built-in Dock badge behavior.
Desired behavior:
Add a setting such as:
- Show Dock badge when a local task/turn completes
- Increment the badge count for completed local tasks that have not been viewed
- Clear the badge when the Codex window/thread is opened or when the user clicks “mark as read”
- Optional: separate behavior for “completed”, “needs approval”, and “failed”
Why this matters:
I do not want banner notifications or sounds. I want a quiet, persistent indicator similar to WeChat/Slack/Mail, where the Dock icon shows a number after Codex finishes work. This is less disruptive than banners but still makes it easy to notice completed work.
Platform:
- macOS
- Codex App version: 26.623.141536
- macOS version: 15.7.5
Related issues:
- #13629 discusses Dock badge semantics for awaiting approvals.
- #10605 shows the macOS Dock badge already exists for Cloud Codex unread counts.
- #26857 discusses unread Automation runs affecting the macOS Dock badge count.
Additional notes:
The current notify hook can run an external command, but it cannot cleanly set the badge count on the Codex.app Dock icon. This likely needs first-party support in the Codex desktop app.
Additional information
_No response_