Codex notifications
on your Mac.

Codex says in its own terminal when it wants approval or has finished a turn. To know from anywhere on your Mac, let Gnista show it in the notch, or use Codex’s own notification settings.

Try free for 7 daysNo account, no card · then €19 once

Updated

The short answer

Install Gnista and tick Codex. Each Codex session gets a row in the notch with its progress, and the notch opens when Codex wants to run a command.

With Gnista

  1. Download Gnista, open it and tick Codex. Gnista backs up ~/.codex/hooks.json and adds its hooks. Codex runs a hook only once it’s trusted, so connecting trusts Gnista’s for you.
  2. Start a session. The row shows whether Codex is working, done or waiting, with its progress. When it wants to run a command, the notch opens with the whole command.
  3. Want to answer there too? In Settings ▸ General, turn on Answer prompts in Gnista. Then Allow, or Deny with a reason Codex reads.

When you can’t see the notch

On another display, behind a full-screen app, or in menu bar mode, Gnista posts a macOS notification instead, and a click takes you to the session’s tab. It stays quiet in that tab, during a Focus or a call, and while your screen is locked or you’re sharing in Zoom.

Without Gnista

  • Codex’s notify setting in ~/.codex/config.toml runs a program of yours when a turn finishes. You write the script that shows the notification.
  • Codex can also send terminal notifications (notifications under [tui]). They show only in terminals that pass them on to macOS, and don’t say which session.

Good to know

  • A hook you turn off in Codex stays off. If Codex ever asks you to trust Gnista’s hooks again, Gnista’s Settings tells you.
  • After /new or /resume, the old session’s row goes about a minute later, when Codex lets it go.
  • Gnista needs macOS 15 or later. Codex on a Linux server, over SSH: connect the server in Settings ▸ Remote. How to set it up.
  • More on Gnista with Codex, including its limits and replies.

More guides.