777genius/agent-notifications

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

What it solves

This project provides a unified way to receive desktop notifications and webhooks for various AI agent command-line interfaces (CLIs) and tools. It solves the problem of missing important updates—such as task completions, tool approvals, or questions—when running long-running AI agent processes in the background.

How it works

The project installs hooks and an MCP (Model Context Protocol) server that integrates with supported AI agents (Claude, Codex, OpenCode, Gemini, and Cursor). When an agent reaches a specific state, such as completing a task or requiring user input, the tool triggers a native desktop notification or sends a webhook to services like Slack, Discord, or Telegram. It also includes features like click-to-focus for terminal sessions and customizable sound alerts.

Who it’s for

This tool is designed for developers and power users who frequently run AI agents in terminal environments and need a reliable way to stay informed about agent progress without constantly monitoring the terminal window.

Highlights

  • Supports multiple agents including Claude, Codex, OpenCode, Gemini, and Cursor.
  • Provides cross-platform desktop notifications for macOS, Linux, and Windows.
  • Enables webhook integration for remote notifications via Slack, Discord, Telegram, and more.
  • Includes focus-aware features like click-to-focus and customizable sound alerts for specific agents.
  • Offers configurable filters and delays to reduce notification noise.

Related

  • Project
    ZekerTop/ai-cli-complete-notify

    AI CLI Complete Notify watches Claude, Codex, OpenCode, Gemini, ZCode (and Herdr) CLI tools, detects when a turn finishes (via log‑watch or native hooks), and pushes a notification through desktop toast, sound/TTS, Telegram, email, or custom webhooks. You can set per‑source enable flags, duration thresholds, and optional LLM‑generated summaries. The project ships a Tauri‑based GUI (Windows, macOS, Linux) and a CLI sidecar (`ai-reminder`) for background watching, one‑off command wrapping, or manual start/stop timers. Configuration lives in a separate `.env` file (webhook URLs, SMTP, LLM API, etc.).

  • Project
    PeonPing/peon-ping

    A notification system for AI coding agents that provides voice-line audio alerts and visual banners when tasks finish or require user input.

  • Project
    dark-hxx/CLI-Manager

    CLI-Manager is a cross-platform desktop workbench that centralizes AI CLI workflows—local and SSH terminals, session history from 11 AI tools, live token/cost analytics, and Git Worktree isolation—so developers can monitor, audit, and continue AI coding tasks without missing approvals or losing context.

  • Project
    YoanWai/agent-manager

    agent-manager is a Go‑based tmux UI that lets developers run, monitor and interact with multiple AI coding agents (Claude, Gemini, Grok, etc.) from a single, mouse‑friendly list, offering quick prompts, diff review, session lifecycle controls and extensive customization.

  • Project
    realfishsam/agent-notch

    A macOS utility that displays visual status indicators for Claude Code and Codex agents next to the MacBook notch, monitoring activity via system processes and transcript files.