Built-in Scanners
HiveScanner ships with 7 built-in scanners that cover the most common developer notification sources.
| Scanner | What It Watches | Auth Required |
|---|---|---|
| GitHub | PR reviews, CI status, @mentions, issue assignments | gh CLI; optional GITHUB_TOKEN |
| Git Status | Uncommitted changes, stale branches, merge conflicts, stashes | None (local) |
| Calendar | Meeting reminders, new/changed events | gws CLI |
| Google Chat | DMs and @mentions in configured spaces | gws CLI |
| New emails, VIP sender urgent alerts via Gmail | gws CLI | |
| Incoming messages from configured chats | whatsapp-cli | |
| Weather | Daily morning briefing, temperature swing alerts | None (wttr.in) |
Enabling a Scanner
Scanners are configured via the /hive wizard or by editing ~/.hivescanner/config.json directly. Each scanner has an enabled field that controls whether it runs during polling cycles.
External Dependencies
Some scanners require external CLI tools:
| Tool | Required By | Install |
|---|---|---|
gh | GitHub | cli.github.com |
gws | Calendar, Google Chat, Email | Google Workspace CLI |
whatsapp-cli | whatsapp-cli |