hushReference
Limits, timing, and data
How often Hush checks GitHub, what it stores, how long it keeps it, and the limits on views, sections, and devices.
Timing and limits
| What | Limit |
|---|---|
| Poll for new notifications, when Hush is open or push is on | every 5 minutes |
| Poll when idle (no open tab for 15 minutes, no push devices) | every 15 minutes |
| First sync after sign-in | notifications from the last 14 days |
| Inbox watcher (turn changes with no notification) | every 15 minutes |
| Pull requests and Issues tabs | cached for 15 minutes; refresh any time |
| Your teams | looked up again every 6 hours |
| Polling stops with no visit for | 14 days (90 days with push devices); opening Hush starts it again |
| A Done thread comes back when it needs you again, within | 7 days |
| A snooze “until something happens” also ends after | 7 days |
| Pushes per poll before they become one push (“5 things need you”) | 3 |
| Alert history (the bell) | 30 days |
| Done threads with no activity are forgotten after | 30 days |
| Saved views | 12 |
| Sections per tab (dash.pr, dash.issue) | 20 |
| GitHub searches per tab | 40 |
| Items per menu | 60 |
| Keys per command | 4 |
| Push devices | 10 |
| Rule snooze (snoozeHours) | 1 to 720 hours |
| Session | 7 days with no use, or 30 days after sign-in; then sign in again |
Hush checks more often while you use it, because a check costs GitHub requests and Cloudflare requests for each user. When you open Hush after a pause, it checks again within a few seconds.
What Hush sees
Hush sees what GitHub puts in your notifications, and the facts of the pull requests and issues behind them. It does not read code. Some changes come with no notification (your own review, CI results, new commits after your review); the inbox watcher finds those within 15 minutes, and the dashboards on their next search.
What Hush stores
- Your account: your GitHub login, name, and avatar, and your token, encrypted.
- Your data, in storage of its own for each user: your threads and their state, the facts of each PR and issue (CI, reviews, the newest comment), your settings, your alert history, your push devices, and your hidden and moved dashboard items.
- Sessions and feeds: a hash of each sign-in session (with its browser and when it was last used), and a hash of each feed address.
Hush keeps Done threads until they have had no activity for 30 days, and alerts for 30 days. Delete account (Settings → General → Account) deletes all of it at once. Nothing is shared with anyone, and Hush has no analytics.
The browser keeps a copy of your lists, so that Hush opens at once. Sign out clears it.
Open source
Hush is open source: github.com/ianmatson/hush. It runs on Cloudflare Workers.