claudeers.
// Developer Tools

ai-agents-notifier

📢 Send system notifications when your AI Coding Agents (CLI-based) requests permissions or completes tasks.

// Developer Tools[ cli ][ desktop ][ web ][ claude ]#claude#awesome-claude-code#claude-ai#claude-code#copilot-cli#notifications#terminal-notification#terminal-notifier#devtools$open-sourceupdated 2 months ago
Actively maintained
100/100
last commit 5 days ago
last release none
releases 0
open issues 0
// star history
★ 75 github ↗

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up ai-agents-notifier (git-clone project) into my current project.
Found on https://claudeers.com/ai-agents-notifier
Repo: https://github.com/hta218/ai-agents-notifier
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/hta218/ai-agents-notifier
Category: devtools. Platforms: cli, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/hta218/ai-agents-notifier

// compatibility

Platformscli, desktop, web
Operating systems—
AI compatibilityclaude
License—
Pricingopen-source
LanguageShell

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:

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:

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

Notification Preview

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

  • 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:

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!

// faq

What is ai-agents-notifier?

📢 Send system notifications when your AI Coding Agents (CLI-based) requests permissions or completes tasks.. It is open-source on GitHub.

Is ai-agents-notifier free to use?

ai-agents-notifier is open-source, so it is free to use.

What category does ai-agents-notifier belong to?

ai-agents-notifier is listed under automation in the Claudeers registry of Claude-compatible tools.

0 views
★ 75 stars
unclaimed
updated 2 months ago

// embed badge

ai-agents-notifier on Claudeers
[![Claudeers](https://claudeers.com/api/badge/ai-agents-notifier.svg)](https://claudeers.com/ai-agents-notifier)

// retro hit counter

ai-agents-notifier hit counter
[![Hits](https://claudeers.com/api/counter/ai-agents-notifier.svg)](https://claudeers.com/ai-agents-notifier)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓
ECC

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 240,305◷ MIT[ claude ]
🔓
gstack

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 128,278◷ MIT[ claude ]
🔓
graphify

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// devtoolssafishamsi/⟨Python⟩★ 109,277◷ MIT[ claude ]
🔓
ponytail

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 104,762◷ MIT[ claude ]
→ see how ai-agents-notifier connects across the ecosystem