quiera
AI agents

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.

Updated 8 November 2026

On this page
  1. The notify option
  2. Codex's hooks
  3. With Quiera

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: /hooks in 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.