This project provides an intelligent notification system for AI CLI task completion, supporting Claude Code, Codex, OpenCode, and Gemini. It targets users who need timely alerts for long-running AI tasks without constant monitoring, offering flexible multi-channel notifications and optional AI summaries to enhance productivity.

How It Works

The tool employs a dual-pronged approach for detecting AI task completion: leveraging explicit "Hooks" or plugins for supported CLIs (Claude Code, Gemini CLI, OpenCode) via lifecycle events, and falling back to "Watch" mode, which monitors local logs and infers completion after a quiet period. This hybrid strategy, combined with "Smart Debouncing" that adjusts notification timing based on task type, ensures accurate and timely alerts across various AI assistants. An optional AI summary feature provides concise task output digests.

Quick Start & Requirements

• Windows: Download portable ZIP from Releases, extract, configure .env, run executable.
• macOS/Linux/WSL: Clone repo, npm install, configure .env, run via node ai-reminder.js or npm run dev.
• Prerequisites: Node.js, npm.
• Links: GitHub Repo

Highlighted Details

• Multi-Channel Notifications: Supports Webhook (Feishu/DingTalk/WeCom), Telegram, Email, Desktop, and Sound alerts.
• Hooks vs. Watch: Prioritizes event-driven Hooks/plugins for Claude Code, Gemini CLI, and OpenCode over log-based Watch mode for improved accuracy and reduced overhead.
• AI Summary: Optional feature to generate concise summaries of AI task outputs.
• Smart Debouncing: Dynamically adjusts notification delay based on task characteristics (e.g., tool calls vs. no tool calls).
• GUI & CLI: Offers a Tauri-based desktop application and a Node.js CLI.
• Configuration: Uses .env for sensitive data and settings.json for GUI-managed settings.

Maintenance & Community

The project is actively maintained, evidenced by a detailed changelog up to v2.4.0 and a recent architecture migration from Electron to Tauri. Contributions are welcomed via Issues and Pull Requests. No specific community links (Discord/Slack) or sponsorship details are provided.

Licensing & Compatibility

The project's license is not explicitly stated in the README, which is a critical omission for adoption decisions, particularly for commercial use. It is designed for integration with AI CLIs like Claude Code, Codex, OpenCode, and Gemini.

Limitations & Caveats

The absence of a specified license poses a significant adoption risk. Log monitoring ("Watch" mode) introduces notification latency due to its reliance on quiet periods. Desktop notifications and tray features are primarily Windows-centric. Optimal performance for certain CLIs depends on the correct setup of their respective Hooks/plugins, while Codex relies on the less immediate Watch mode.