Use Hush

Inbox

How Hush sorts notifications, what each tab and row shows, and how Done, Snooze, Mute, and Read work.

Tabs

Tab	What is in it
Needs you	Threads where you are the next person who must act.
FYI	Activity that you may want to know about, but that does not need you.
Snoozed	Threads that you snoozed. They come back at the time, or when the thing happens.
Done	Threads that you (or Hush, or a rule) finished.
Muted	Threads that you muted, or that a rule mutes.

After these come your saved views. Keys 1 to 5 open the built-in tabs, and 6 to 9 your first four saved views.

What needs you

Hush reads each notification and the pull request or issue behind it (CI, reviews, comments, conflicts), and decides whose turn it is. A thread is in Needs you when one of these is true:

Your pull requests (not drafts):

CI fails.
Someone requested changes.
It has merge conflicts.
It is approved, but review threads are still open.
It is approved and CI is not running: it is ready to merge.
A person commented after your newest push.

Other people's pull requests:

Your review is requested from you by name (or again, after your review).
It is assigned to you.
New commits arrived since your review.
A review is requested from one of your teams, only with teamReviewsAreAction on.

Issues: it is assigned to you; or someone replied on an issue that is assigned to you or that you opened.

Conversations: a person mentioned you, or replied in a thread that you commented in (and you did not reply since).

Other: security and Dependabot alerts, repository invitations, deployments that wait for your approval, and workflow runs that failed.

Everything else is FYI: team mentions, repositories that you watch, merged and closed work, passing CI, releases. With botsAreFyi on (the default), PRs, comments, and mentions by bots are FYI too.

The same rules make the “Your turn” group on the Pull requests and Issues tabs, so an item is in Needs you exactly when it is your turn there. To change where threads go, write rules.

Rows

Each row shows:

What happened, in one line: “CI failed on your PR”, “@alice requests your review”, “@github-actions commented on your PR”.
The title, the repository, and the number.
Why GitHub notified you: “Review requested”, “You opened this”, “Watching repo”…
rule: … when one of your rules sorted it.
A note such as “✓ You approved” when Hush moved it to Done by itself.
The time and the condition of a snooze.
A dot when it is unread.
The main action button: Review, Fix CI, Address, Resolve, Merge, Reply, Triage, or Open. It opens the right page on GitHub (the files of a PR to review, its checks to fix CI) and marks the thread as read.

Click a row to peek at it.

Triage

Each action works on the row under the cursor, or on every selected row.

Action	Key	What it does
Done	`E`	Moves the thread to Done, and marks it done on GitHub.
Snooze	`S`	Hides it until tomorrow at 9:00. The Snooze menu has more times and conditions.
Mute	`M`	Moves it to Muted, and unsubscribes you on GitHub, so GitHub stops notifying you about it.
Read / Unread	`U`	Marks it as read (also on GitHub) or unread (only in Hush).
Move to inbox / Unmute		In Snoozed, Done, and Muted: brings it back.

After each action, a message with Undo shows for a few seconds.

What comes back by itself

New activity brings a Done thread back. When GitHub sends a new notification for it, the thread is in the inbox again. A muted thread stays muted.
Hush finishes threads for you. When a thread in Needs you stops needing you (you approved, you pushed a fix, CI passes now, it was merged), Hush moves it to Done with a note that says why. If it needs you again within 7 days (someone requests changes again, CI fails again), it comes back to Needs you.
FYI about work that closed moves to Done when it is merged or closed.

Snooze

The Snooze menu has times and conditions. A time is on your computer's clock.

For 1 hour, for 3 hours, until tomorrow 9:00, or until next Monday 9:00.
Until something happens:

Snooze until	For	Menu id
CI passes	Pull requests	`until:ci_pass`
CI finishes	Pull requests	`until:ci_done`
Someone approves	Pull requests	`until:approved`
A new review	Pull requests	`until:review`
New commits	Pull requests	`until:commits`
Someone replies	Pull requests and issues	`until:reply`
It is merged or closed	Pull requests and issues	`until:closed`

A snooze “until” also ends after 7 days, so nothing sleeps forever. If the PR or issue is merged or closed first, the snooze ends at once, because the event can no longer happen. When a snooze ends because the thing happened, Hush pushes “Snooze over: CI passed”. Conditions that are already true are not offered.

A rule can snooze threads for a number of hours when they arrive.

Select many

X selects or deselects the row under the cursor. Shift + J and Shift + K extend the selection.
⌘-click (Ctrl-click) adds a row; Shift-click selects a range; ⌘ A / Ctrl + A selects all.
With a selection, a bar at the bottom has Done, Snooze, Mute, and Read. The keys and the right-click menu act on all selected rows.
Esc clears the selection.

Filter

The filter box above the list takes words and query words:

repo:acme/* needs:review -author:bots

Plain words must all be in the title, the repository, or the author. Suggestions show while you type; / goes to the box. When a filter has an error, the message shows under the box, and the part with the error is left out.

To keep a filter, choose the bookmark button at the end of the box: Save this filter as a view (a new tab). See Saved views.

Right-click a row (or choose “⋯” on a phone) for every action: Peek, the main action, Open on GitHub, Done, Snooze, Mute, Move to inbox, Mark as read, Copy link, Make a rule…, and selection. With a selection, the menu acts on all selected rows. You can change the items and their order: see Menus.

Make a rule… opens Settings → Inbox with a new rule for this thread's repository and type.

Sync

Hush checks GitHub every few minutes by itself (see Limits), and open tabs update at once when something changes. The line under the tabs says “Synced 2m ago”, or “Syncing…” while a check runs.

To check now, press R or choose the refresh button. This also looks again at up to 40 threads in the inbox, and moves the ones that no longer need you to Done.