ZekerTop / ai-cli-complete-notify

AI CLI Complete Notify (v2.1.0) English | 中文 📖 Introduction An intelligent task completion notification tool for Claude Code / Codex / Gemini, supporting multiple notification channels and flexible configuration options. Get notified automatically through various methods when AI assistants complete long-running tasks, so you don't have to wait in front of your computer. **Supported Notification Methods:** 📱 Webhook (Feishu/DingTalk/WeCom) • 💬 Telegram Bot • 📧 Email (SMTP) 🖥️ Desktop Notifications • 🔊 Sound/TTS Alerts • ⌚ Smart Band Alerts ✨ Key Features(For more detailed update logs, please refer to the end of the article) • 🎯 **Smart Debouncing**: Automatically adjusts notification timing based on task type - 60s for tool calls, only 15s without tool calls • 🔀 **Source Control**: Independent enable/disable and threshold settings for Claude / Codex / Gemini • 📡 **Multi-Channel Push**: Support multiple notification methods simultaneously to ensure message delivery • ⏱️ **Duration Threshold**: Only notify when tasks exceed the set duration to avoid frequent interruptions • 🪝 **Hooks + Watch Integration**: Claude Code / Gemini CLI can use native hooks for near-instant alerts, while Codex continues through log watching • 🧠 **AI Summary (Optional)**: Generate a short summary quickly; fallback to the original task if it times out • 🖥️ **Desktop Application**: GUI configuration with language switching, tray hiding, and auto-start • 🔐 **Configuration Separation**: Runtime configuration separated from sensitive information for security 💡 Recommended Configuration **Important**: For the best experience, it's recommended to grant AI assistants **full file read/write permissions** when using Claude Code / Codex / Gemini. Benefits: • ✅ Ensures task logs are correctly recorded to local files • ✅ Monitoring functions can accurately capture task completion status • ✅ More precise notification timing, avoiding false positives or missed notifications • ✅ AI can better manage project files and configurations Important Notes • Claude Code often splits a request into sub-tasks. To avoid spam, this tool only notifies after the whole turn completes. • Log monitoring relies on a quiet period to confirm completion, so notifications are not instant (default 60s with tool calls, 15s without). • For the fastest and cleanest alerts, prefer Hooks for Claude Code / Gemini CLI; keep Watch for Codex or as a general fallback mode. Hooks vs Watch • **Hooks** use native lifecycle events emitted by the AI CLI itself. For Claude Code and Gemini CLI, that means reminders can fire closer to the real finish point instead of waiting for a quiet-period guess. • **Hooks** do not require a long-running background watcher for those tools, which reduces idle overhead and lowers the chance of log-parsing false positives. • **Watch** remains the universal fallback. It works well for Codex and for cases where hooks are not configured, but it depends on local logs and debounce time to infer that a turn has ended. • In practice, Hooks were added mainly because Claude Code's event and Gemini CLI's event provide more timely and accurate completion signals than watch-based log polling for those two tools. In the current integration, Codex still uses Watch as the main completion path. 🚀 Quick Start Windows Users • Download the latest from Releases • Extract the archive and place it in any directory (e.g., ) • Copy to and fill in your notification configuration according to the requirements inside • Double-click to run the desktop application macOS / Linux Users 🖥️ Desktop Application Usage Interface Overview • **Top Bar**: Language switching, Watch monitoring toggle, window controls • **Channel Configuration**: Configure Webhook, Telegram, Email, and other notification channels • **Source Settings**: Set enable status and duration thresholds for Claude / Codex / Gemini separately • **Monitoring Configuration**: Set polling interval and debounce time with smart adjustment support • **Confirm reminder (default: OFF)**: Effective only in Watch mode. When enabled, it triggers only when Codex shows an interactive choice prompt that requires your selection or submission (Plan mode); normal output text will not trigger it. Only one reminder is sent per turn: once a confirm reminder is triggered, that turn will not send a separate task-complete reminder. • **Watch logs**: Persisted locally with one-click open and retention days. • **Test Function**: Test whether each notification channel works properly • **AI Summary**: Configure API URL / Key / Model and timeout fallback • **Advanced Options**: Title prefix, close behavior, auto-start on boot, silent start (hide to tray on launch), click notification to return (best-effort; OS focus rules may block) Interface Preview   Tray Function After selecting "Hide to tray", the application minimizes to the system tray. The icon may be in the ^ collapsed area of the taskbar. With silent start enabled, the app launches hidden in the tray without a balloon. 💻 Command Line Usage > WSL note: CLI reminders work for webhook/Telegram/email, and sound can also work in WSL through Windows PowerShell. Desktop notifications and tray are Windows-only. Log monitoring works only when the AI CLI runs inside WSL (logs under , , ). For WSL/CLI config, use for AI summary and Feishu card; overrides . Note: For CLI usage from source (Node), run first. On Windows portable builds: • is the desktop GUI. • is the packaged CLI/sidecar and should be used for terminal commands. WSL Quick Command Guide (Copy & Run) Notes: • In WSL, prefer webhook/Telegram/email channels; tray is a Windows GUI feature. • For WSL CLI behavior, configure first ( overrides ). Direct Notification Native Hooks Mode (Recommended for Claude Code / Gemini CLI) Notes: • Claude Code currently uses the native hook event. • Gemini CLI currently uses the native hook event. • In the current integration, Codex completion r…