opencode-notify
Gentle Reminders from OpenCode AI While You Stay Focused
Say goodbye to the anxiety of frequent window switching. opencode-notify provides native desktop notifications for your OpenCode AI, featuring smart focus detection, quiet hours, and click-to-focus (macOS). Stay focused on your work and be precisely alerted only when the AI needs your attention.
Stay Focused, Get Smart Notifications
Use your operating system's native notification system (macOS Notification Center, Windows Toast, Linux notify-send), seamlessly integrating into your workflow.
Automatically detects terminal window focus to avoid duplicate notifications. By default, only notifies parent sessions, filtering out subtask noise so you focus on what truly matters.
Set quiet time periods (e.g., 22:00-08:00) to automatically suppress notifications at night. Supports cross-midnight time periods to protect your rest time.
macOS users can click notifications to automatically focus the terminal window, saving time switching between applications and doubling productivity.
Set exclusive sound effects for different event types (Glass, Basso, Submarine, etc.) to quickly identify notification types by sound.
Supports 37+ terminal emulators including Ghostty, iTerm2, WezTerm, VS Code integrated terminal, automatically recognizing your terminal type.
All notifications are generated locally with no data uploaded to the cloud. Your work content remains completely private and secure.
Built with TypeScript + Bun. Install and use immediately with clean configuration files. No need to learn complex configurations.
Introduces complete macOS platform features (focus detection, click-to-focus, custom sound effects)
Introduces Windows platform features (native notifications, terminal detection)
Introduces Linux platform features (native notifications, terminal detection)
Lists all supported terminal emulators (37+ terminals)
Provides complete configuration option descriptions and examples
Explains how to set up quiet hours to avoid disturbances during specific time periods
Explains the terminal auto-detection mechanism and how to manually specify terminal type
Provides configuration tips and best practices