Feature request: notifications when codex is done with a task

It would be great to have the option to receive notifications when Codex completes a task. Especially when managing tasks concurrently, it is annoying to have to constantly check if codex is done.

This is extremely necessary. Please add web notification. Jules already have it.

+1 for that feature. Its not really a “background agent” if i have the tab open all the time checking if its done already.

I want this too. +1 from me!

+1 just copy claude code CLI

+1. I need a Lark notification when the task is finished or intervene is asked.

It is possible to get notified via Codex configuration and a little scripting, though. I have had this running the last days and it really helped my workflow. I have written a blogpost on how this works here: https:// kanman .de/en/posts/codex-desktop-notifications/

Codex supports “notify” in its config and you can set up a command it should invoke. That command receives a JSON payload with the user and assistant prompts. If you set up a little scripting you can use that info to show a desktop notification or send push messages to your phone. This also works in WSL environments. I also use pushover to get the notifications to my phone when my laptop is locked (which I do when I leave the desk with Codex working). Works pretty good for me.

Would love this for the VSCode extention too, seriously missing this compared to things like antigravity.

This is an ugly stop-gap solution, but until OpenAI adds support for bespoke notifications, you could use the notify hook to trigger a system sound like so on macOS:

notify = [
  "bash",
  "-lc",
  "osascript -e 'display notification \"Task finished\" with title \"Codex\"'; afplay /System/Library/Sounds/Glass.aiff",
]

I’ve created a skill for this here. Should run automatically whenever agent completes a job. Note that it currently only works for mac

+1 on this being a much-needed feature. @kevin13’s skill is solid for Mac users at their desk.

I had the same itch and ended up building relayd.dev to solve it from a different angle.
It’s a mobile app that sends push notifications when Codex agents finish, so you can actually walk away and do other things. Lets you manage multiple agents from your phone too.

Would love OpenAI to build this natively, but until then these workarounds help.

For anyone landing here from search: the Codex CLI has this built in now, including a notification when it stops to ask for approval.

In ~/.codex/config.toml:

[tui]
notifications = ["agent-turn-complete", "approval-requested"]
notification_condition = "always"

By default these only show when the terminal is not focused; notification_condition = "always" shows them even when it is.

For Slack, Lark or phone alerts, notify (a top-level key, so put it above any [table] line) runs your own program after every completed turn and passes it one JSON argument that includes last-assistant-message, so a small script can forward it anywhere. It fires only when a turn completes, not on approval requests, so keep approval-requested above for those.

I wrote both up with a full example script in the Codex notifications guide on the Orbtile site (disclosure: Orbtile is an app I make).

Hi everyone, thanks for sharing your use cases, and @diogomendes for adding the CLI configuration.

For CLI users, those settings match the official notification documentation: they support turn-completion and approval-request alerts.

How they appear or sound depends on your terminal. The separate notify option runs your own program for completion alerts; it doesn’t fire for approval requests.

For desktop users, Settings includes completion alerts and separate permission and question notifications. The notification guide also explains the options for web and the IDE extension.

If alerts still aren’t arriving, please start a new thread with the Codex surface, app or CLI version, operating system, and which alert is missing.

~AD