ZekerTop/ai-cli-complete-notify

What it solves

AI CLI tools like Claude Code, Gemini CLI, and Codex often perform long-running tasks (such as complex coding or project-wide refactoring) that require the user to wait. This tool prevents the need to stay glued to the terminal by sending automatic notifications across various channels when a task is completed.

How it works

The tool monitors AI assistant activity through three primary methods:

1. Hooks/Plugins: The preferred method for Claude Code, Gemini CLI, and OpenCode, which uses explicit lifecycle events emitted by the AI CLI to trigger notifications immediately upon completion.
2. Log Watching: A universal fallback that polls local logs and uses "smart debouncing" (waiting for a quiet period of 15-60 seconds) to infer when a task has ended.
3. Manual/Auto Timers: Users can wrap AI commands or manually start/stop timers to trigger alerts.

Once completion is detected, the tool can send notifications via Webhooks (Feishu, DingTalk, WeCom), Telegram bots, Email (SMTP), desktop notifications, or sound/TTS alerts. It can also optionally use an LLM to generate a short summary of the completed task before sending the alert.

Who it’s for

Developers using AI-powered command-line interfaces (CLIs) who run time-intensive tasks and want to be notified on their desktop or mobile devices when the AI finishes its work.

Highlights

• Multi-Channel Support: Push alerts to Telegram, Email, Webhooks, and system notifications simultaneously.
• Smart Debouncing: Adjusts notification timing based on whether the AI is making tool calls or just generating text to reduce false positives.
• AI-Powered Summaries: Optional integration with LLM providers to summarize the task output for the notification message.
• Cross-Platform GUI: Includes a desktop application for easy configuration of channels, thresholds, and source settings on Windows, macOS, and Linux.
• Flexible Integration: Supports both native hooks for precision and log-watching for compatibility with tools like Codex.