Codex Notifications

Clickable Omarchy notifications for Codex lifecycle events. Clicking a notification (or invoking it with SUPER + ALT + COMMA) focuses the terminal, tmux pane, or Herdr agent pane that is running the corresponding Codex instance.

Notification screenshot

Install

omarchy plugin add https://github.com/brianblakely/omarchy-codex-notifications.git --enable --yes

To complete the install, close all instances of Codex, open a fresh one, and run /hooks to review and trust the new notification handler. Notification handlers are added to ~/.codex/hooks.json for all supported events without disrupting any pre-existing handlers.

Configure

Settings are configured in ~/.config/omarchy/shell.json. Here are the defaults:

{
  "id": "b.codex-notifications",
  "events": ["PermissionRequest", "Stop"],
  "notifyWhenFocused": true
}

events accepts these Codex lifecycle hooks:

SessionStart
SessionEnd
SubagentStart
PreToolUse
PermissionRequest (notifications suppressed when auto-approve is enabled)
PostToolUse
PreCompact
PostCompact
UserPromptSubmit
SubagentStop
Stop

notifyWhenFocused defaults to true; set it to false to notify only while Codex is in the background.

Update

omarchy plugin update b.omarchy-codex-notifications

Uninstall

omarchy plugin remove b.omarchy-codex-notifications