Codex notifications: know when Codex is done or waiting
Codex CLI can also tell you when it finishes or waits for a permission. Two mechanisms exist.
On this page
The notify option
In ~/.codex/config.toml, the notify key runs a program at the end of each Codex turn. It's simple, but it only signals the end, not permission requests.
Codex's hooks
Recent Codex versions have hooks close to Claude Code's, in ~/.codex/hooks.json: SessionStart, UserPromptSubmit, PreToolUse, PermissionRequest, PostToolUse, Stop, SessionEnd. Two quirks:
- On Windows, Codex runs them through PowerShell.
- Codex asks you to trust new hooks once:
/hooksin Codex, then “Trust all”.
With Quiera
In Quiera, Settings › AI agents › Codex installs these hooks for you. Then open Codex once and trust them: the island shows what Codex does, tells you when it's done, and lets you allow or deny its commands. Your Codex plan's usage shows too, read from its session files.