Claude Code notifications
on your Mac.
Claude Code waits quietly in its terminal when it needs you. To hear about it anywhere on your Mac, let Gnista show it in the notch, or set up Claude Code’s own notifications. Here’s each, and what it can’t do.
Updated
The short answer
Install Gnista and tick Claude Code. Every session gets a row in your MacBook’s notch: amber while it works, red when it needs you, green when it’s done. When it needs you, the notch opens by itself with the request.
With Gnista
- Download Gnista and open it. Choose the notch, the menu bar, or both.
- Tick Claude Code in the list of agents it found. Gnista backs up
~/.claude/settings.jsonand adds its own hooks, keeping yours. - Start a Claude Code session. When it asks for permission or asks you a question, the notch opens for five seconds with the request. When a turn ends, its drop turns green and a soft sound plays.
- Set how loud it is in Settings ▸ Notifications: Peek, Dot only or Off, sounds, and one reminder after a few minutes if you want it.
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. Click it, and you land in the session’s terminal tab.
It stays quiet in the session’s own tab, during a Focus or a call, while your screen is locked or you’re sharing in Zoom, and for anything under Settings ▸ Notifications ▸ Don’t notify for: a folder or an agent. To silence one session, right-click its row and choose Don’t Notify for This Session.
Without Gnista
- Claude Code’s own notifications:
/confighas a setting for them, from a terminal bell to a notification in terminals that support one, such as iTerm2. It tells you something happened, not which session. - A hook of your own: Claude Code’s
NotificationandStophooks can run any command, such asosascriptto show a notification. Free and flexible, but you write and keep it working, and clicking it won’t take you to the right tab.
Good to know
- Gnista needs macOS 15 or later. It doesn’t run on Windows or Linux, and sends no phone notifications.
- Cowork sessions in the Claude app run in a virtual machine, so their hooks never reach your Mac: Gnista reads them from the Claude app instead, and a click opens them there.
- Claude Code on a Linux server, over SSH: connect the server in Settings ▸ Remote, and its sessions show here with the machine’s name. How to set it up.
- Disconnect Claude Code in Settings ▸ Agents and exactly Gnista’s hooks go.
- Seven days free, then €19 once. More on Gnista with Claude Code.
More guides.
Codex notifications
on your Mac.Know when Codex has finished, or wants to run a command, without watching its terminal.
Approve Claude Code requests
without switching windows.Allow or deny a command or an edit from the notch, then carry on with what you were doing.
Claude Code and Codex limits,
at a glance.Your 5-hour and weekly limits for Claude Code and Codex, under your sessions.
Agents in Xcode,
in your notch.Know when Claude, Codex or Antigravity in Xcode needs you, without keeping Xcode in front.
Agents on a server,
answered from your Mac.Claude Code, Codex and more on a server or another Mac: know when they need you, and answer from your Mac.
Agents in containers,
within reach.Claude Code or Codex in a devcontainer or a Kubernetes pod: their requests still reach your notch.