777genius/agent-notifications

What it solves

Agent Notifications provides a way to stay informed about the progress of AI agents like Claude Code and Codex CLI without having to constantly monitor the terminal. It solves the problem of "blind waiting" by sending system notifications, playing sounds, and triggering webhooks when specific agent events occur (such as task completion, API errors, or requests for user input).

How it works

The project is a cross-platform plugin that integrates with the agent's hook system. It monitors for specific triggers—such as the Stop or PreToolUse hooks—and maps these events to notifications. For example, it can detect when a task is complete or when aude has a question for the user based on the state machine and text heuristics. It also includes a "Click-to-Focus" feature that uses platform-specific APIs (like AX API on macOS or D-Bus on Linux) to automatically bring the correct terminal window, tab, or pane back into focus when a notification is clicked.

Who it’s for

Developers using Claude Code or Codex CLI who want to increase productivity by multitasking while their AI agents perform complex, long-running tasks in the background.

Highlights

• Multi-Agent Support: Works with both Claude Code and Codex CLI.
• Deep Terminal Integration: Click-to-focus support for a wide array of terminals (Ghostty, VS Code, iTerm2, Warp, kitty, WezTerm, etc.) and multiplexers (tmux, zellij).
• Rich Notifications: Includes sound alerts (MP3/WAV/FLAC/OGG/AIFF) and git branch display in notification titles.
• Extensive Webhook Integration: Supports Slack, Discord, Telegram, Microsoft Teams, ntfy.sh, PagerDuty, and more, with built-in retry and rate limiting.
• Cross-Platform: Native support for macOS, Linux, and Windows 10+.