Codex Desktop for macOS: native notification when waiting for permission approval

Open 💬 1 comment Opened Jun 19, 2026 by wardoost

Codex Desktop for macOS: native notification when waiting for permission approval

Summary

Please add a built-in native macOS notification banner when Codex Desktop is waiting for the user to approve a permission request.

Problem

When Codex is working in the background and reaches a permission gate, the session can sit idle until the user happens to return to the Codex window. This is easy to miss during longer tasks, especially when working in another app or away from the active workspace.

This request is specifically for a product-level Codex Desktop notification on macOS, not a custom hook/API workaround.

Desired behavior

  • When a Codex session transitions into a user-facing approval state, Codex Desktop posts a native macOS notification.
  • The notification works when the Codex window is in the background or minimized.
  • Clicking the notification focuses Codex Desktop and opens the relevant thread/approval prompt.
  • The notification should be de-duplicated or throttled so repeated permission checks do not spam the user.
  • Ideally the feature can be controlled in settings, with options such as:
  • notify only when Codex is in the background;
  • notify for all permission requests;
  • disable permission notifications.

Privacy and safety

The notification text should avoid exposing sensitive command details by default. A safe summary such as "Codex is waiting for permission" would be enough, with details visible only after opening the app.

Why this matters

This would reduce stalled sessions and bring Codex closer to the workflow users expect from tools like Claude Code, where the user can safely let the agent run in the background and be notified when attention is needed.

Related issues

Related, but not exact duplicates:

  • #28833 asks for hook/API signal improvements so custom notification scripts can avoid false positives. This request is for built-in Codex Desktop macOS notifications.
  • #13629 asked for a dock badge count for awaiting approvals. This request is for native macOS notification banners with click-to-focus behavior.
  • #26005 and #25284 discuss Windows-specific permission notification bugs. This request is for the macOS Desktop product behavior.

Environment

  • Product: Codex Desktop app
  • Platform: macOS
  • Local CLI version observed: Codex CLI 0.135.0
  • Local OS observed: macOS 15.7.7

Notes

I checked the local Codex CLI surface with codex --help, codex features list, and codex doctor; I did not find an exposed built-in setting for native permission notifications.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗