agent-notify

Agent-Notify is a small tool that sends your computer a desktop notification whenever an AI coding assistant finishes a task or needs your attention. If you use Claude Code, OpenAI Codex, Google Gemini CLI, or the Cursor editor's agent mode, you can run this in the background and step away from your screen without missing the moment the AI is done and waiting for you.

The tool hooks into the notification or hook systems that each AI tool already exposes. For Claude Code, it writes entries into a settings file that Claude checks at the end of each task. For Codex and Gemini, it does the same through their respective config files. When the AI finishes or pauses for a decision, the hook fires a script that triggers a system notification on macOS, Linux, or Windows. No middleware or cloud service is involved.

Installation is intentionally simple. On macOS you can use Homebrew with a single command. On Linux or Windows, there are one-line install scripts. An npm path also works across all three platforms. Once installed, running the command an on scans for whichever supported AI tools you have and enables notifications for all of them at once. You can also enable per-tool or per-project rather than globally.

Beyond basic pop-up alerts, the tool supports playing a custom sound when a task completes and reading out a voice announcement on macOS and Windows. You can control which kinds of events trigger notifications: by default it only alerts when the AI is idle and waiting for input, but you can add alerts for tool permission requests or when sub-agents finish.

The project is a fork of an earlier tool called code-notify and is released under the MIT license.