inbox-watch

Poll inbox notifications and trigger inbox-triage for actionable items.

2|Updated Apr 2, 2026

Search Tags:#automation #notifications #inbox #polling #state-management #launchd #inbox-triage

Ready to run

npx skills add https://github.com/jackleeio/bnbot-kit --skill inbox-watch

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: inbox-watch
Source: https://github.com/jackleeio/bnbot-kit/tree/main/skills/inbox-watch
Command: npx skills add https://github.com/jackleeio/bnbot-kit --skill inbox-watch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the lifecycle management of the auto inbox poller, enabling reliable wake/sleep control, notifications scraping, and triggering inbox triage when fresh actionable items appear, reducing manual monitoring.

Core Features & Use Cases

Two-step install/start flow to prevent accidental live runs and ensure explicit opt-in.
Interval-based polling with stateful deduplication to catch actionable items efficiently.
Automatic triggering of /inbox-triage --auto when new actionable notifications are detected, with logs and session reports.

Quick Start

Install the inbox watcher and start the polling to enable automatic inbox monitoring.

Frequently Asked Questions about inbox-watch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automate inbox polling to detect actionable notifications on macOS?▼

Automate inbox polling by deploying a launchd agent that wakes every N minutes to fetch notifications, deduplicates against local state, and triggers triage when actionable items appear. This reduces manual monitoring overhead reliably.

How does stateful deduplication work for recurring notification polling?▼

Stateful deduplication for notification polling works by fetching all current notifications and comparing them against local state records. It filters out previously seen items, ensuring only fresh actionable notifications trigger downstream processing.

Can I use a launchd agent for scheduled execution in a macOS-like environment?▼

Yes, you can use a launchd agent for scheduled execution in a macOS-like environment. The agent manages the wake and sleep lifecycle, waking every N minutes to execute polling tasks and ensuring explicit opt-in before running.

What is the best way to prevent accidental live runs when setting up automated polling?▼

The best way to prevent accidental live runs during automated polling setup is using a two-step install and start flow. This ensures explicit opt-in by requiring separate installation and activation phases before execution begins.

How do I automatically trigger inbox triage when new actionable items are detected?▼

Automatically trigger inbox triage by configuring the poller to spawn an auto-triage process when actionable notifications are detected. The system logs the event and generates session reports for tracking.