agent-notifications

πŸ”” Cross-platform smart notifications for Claude/Codex/OpenCode/Cursor/Gemini/Qoder/Pi. Desktop alerts, sounds, click-to-focus, and webhooks. macOS, Linux, and

What is agent-notifications?

πŸ”” Cross-platform smart notifications for Claude/Codex/OpenCode/Cursor/Gemini/Qoder/Pi. Desktop alerts, sounds, click-to-focus, and webhooks. macOS, Linux, and Windows.

Overview of agent-notifications

What it is

Agent Notifications is a cross-platform notification system for AI coding agents. It sends desktop alerts, plays sounds, allows click-to-focus, and supports webhooks. It works with Claude, Codex CLI, OpenCode, Gemini CLI, and Cursor CLI on macOS, Linux, and Windows. It is licensed under GPL-3.0-or-later.

Key features

  • Task and attention alerts: completions, questions, tool approvals, and more, depending on the agent
  • Click-to-focus and sounds (Claude/Codex): focus the originating terminal or editor; choose built-in or custom sounds, volume, and audio output
  • Useful context: desktop alerts show project, git branch, and native session names; question alerts show the current question when supplied
  • Less noise (Claude/Codex): optional focus-aware delivery, delays, filters, and subagent alerts
  • Webhooks: send alerts to Slack, Discord, Telegram, Lark/Feishu, and custom endpoints
  • Cross-platform: macOS (Intel/Apple Silicon), Linux (x64/ARM64), and Windows 10+ (x64)

Use cases

Getting notified when an AI agent completes a task, needs a question, or requests tool approval without keeping the terminal constantly visible. Integrating agent alerts into team communication channels via webhooks. Using click-to-focus to jump directly to the terminal where the agent is running.

Getting started

bash(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash)For Codex only:bash(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --product codex)See the repository README for detailed setup instructions, prerequisites, and platform-specific notes.

License and pricing

License: GPL-3.0-or-later. Pricing: open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/777geniusagent-notifications.svg)](https://yunodb.com/tools/777geniusagent-notifications?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/777geniusagent-notifications?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/777geniusagent-notifications.svg" alt="Featured on YunoDB" height="20"></a>