AI Agents Notifier

📢 Desktop notifications for CLI-based AI coding agents

A cross-platform notification system that integrates with command-line AI coding agents to show desktop notifications for sessions, completions, and permission requests.

Note: This is specifically for CLI/terminal-based AI agents, not IDE extensions or web-based coding assistants.

Supported AI Agents

• ✅ Claude Code CLI - Native hook integration
• ✅ GitHub Copilot CLI - Native hook integration
• 🔜 Gemini CLI - Not yet implemented (PRs welcome!)

Installation

Claude Code CLI

📖 See claude/SETUP.md for installation instructions

Quick start:

bashCopy
curl -o ~/.claude/claude-code-notifier.sh \
  https://raw.githubusercontent.com/hta218/ai-agents-notifier/main/claude/claude-code-notifier.sh
chmod +x ~/.claude/claude-code-notifier.sh

Then configure ~/.claude/settings.json - see claude/settings.example.json

---

GitHub Copilot CLI

📖 See copilot/SETUP.md for installation instructions

Quick start:

bashCopy
curl -o ~/.copilot/copilot-cli-notifier.sh \
  https://raw.githubusercontent.com/hta218/ai-agents-notifier/main/copilot/copilot-cli-notifier.sh
chmod +x ~/.copilot/copilot-cli-notifier.sh

Then configure hooks per-project in hooks.json (project root) - see copilot/settings.example.json

Note: Copilot CLI hooks are project-based. You need to create hooks.json in the root of each repository where you want notifications.

---

Usage

Claude Code CLI

📖 See claude/SETUP.md

Notifications appear for:

• SessionStart → "Session started 🚀"
• SessionEnd → "Session completed ✅"
• Stop → "Response finished 🏁"
• Notification → Original message from Claude

---

GitHub Copilot CLI

📖 See copilot/SETUP.md

Notifications appear for:

• sessionStart → "New session started 🚀" / "Session resumed ♻️"
• sessionEnd → "Session completed ✅" / "Session ended with errors ❌"
• preToolUse → "Permission: [tool] 🔔" (when about to execute)
• errorOccurred → "Error: [error type] ⚠️"

---

Requirements

macOS (recommended)

• terminal-notifier for pushing notifications
• jq for JSON processing
• Install: brew install terminal-notifier jq

Linux

• notify-send (usually pre-installed)
• Install if missing: sudo apt install libnotify-bin

Windows

• PowerShell (built-in on modern Windows)
• Uses Windows Toast notifications

Customization

See each agent's SETUP.md for customization options:

• claude/SETUP.md
• copilot/SETUP.md

Contributing

Contributions are welcome!

Want to add support for another CLI-based AI agent?

• Gemini CLI integration needed
• Other CLI AI coding agents welcome

Feel free to submit issues and pull requests!