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.