ai-agents-notifier

Send system notifications when your AI Coding Agents (CLI-based) requests permissions or completes tasks. Benefits developers by reducing context switching and improving workflow efficiency. Integrates with CLI-based AI coding agents like Claude Code and Copilot CLI.

[{"step":1,"action":"Identify your AI coding agent and notification channel. For example, if using Copilot CLI, set up a Slack webhook URL for notifications.","tip":"Use `echo $PATH` to confirm your agent's CLI path. For Slack, create a webhook via Slack API under 'Incoming Webhooks'."},{"step":2,"action":"Pipe the agent's output to a script that parses for permission requests or task completions. Example for Copilot CLI: `copilot /project --watch | python3 ai_notifier.py --channel slack`.","tip":"Use `tee` to log output to a file while piping to the script for debugging: `copilot /project --watch | tee copilot.log | python3 ai_notifier.py`."},{"step":3,"action":"Run the notification script with the required arguments. Example: `python3 ai_notifier.py --agent copilot --channel desktop --format detailed`.","tip":"Test the script with a mock output file first: `python3 ai_notifier.py --test /path/to/mock_output.txt`."},{"step":4,"action":"Monitor notifications in your chosen channel. For Slack, check the dedicated channel; for desktop, ensure notifications are enabled in system settings.","tip":"Adjust notification frequency by filtering low-priority tasks (e.g., ignore file reads) in the script's logic."},{"step":5,"action":"Iterate based on feedback. If notifications are too frequent, refine the parsing logic to focus on critical actions like file writes or deletions.","tip":"Use regex patterns to match specific phrases like 'permission to write' or 'task completed' for more precise filtering."}]