You need the app first. It takes a minute.
Agent Notifier is a menu-bar app. It watches for your agent’s hook, draws a companion over whatever you are doing, and gets out of the way. It never opens a window, takes focus, or touches the network.
Install the app
Not released yetA menu-bar app for macOS 13 or newer, Apple silicon and Intel. No dock icon, no login-item prompt, no account.
There is no download yet. The release pipeline is built and refuses to publish a build that is not signed, accepted by Gatekeeper and stapled — and the certificate that makes that possible has not been bought. Until then the app runs from source.
Wire the hook into your agent
This is the part people get stuck on, so the app hands you a prompt for it too. Paste it into the agent and it edits its own config — after backing the file up first.
Add the Agent Notifier hook to your settings so this session notifies me when it finishes, needs input, or fails. Run: agent-notifier-desktop setup Then tell me what it printed.
The hook itself is a safety boundary, not a convenience: one second of timeout, always exit zero, never writes to stdout or stderr. A notifier that can stall your agent is worse than no notifier.
What does not work yet
- macOS only. The install prompt is cross-platform; the app is not.
- Claude Code today. Codex, Gemini and Cursor adapters are deferred rather than half-done.
- Hover to pause and click to dismiss are specified and not built.
- Creator accounts do not exist. Submissions go in as a pull request authored by your own GitHub account, and a maintainer merging it is what publishes it.