Use Hush

Pull requests and issues

The dashboards of open work that involves you, grouped by whose turn it is.

The Pull requests and Issues tabs show open work that involves you, also when GitHub sent no notification about it. Each tab is a set of saved GitHub searches, called sections. Hush groups the results by whose turn it is.

Groups

Group	Means
Your turn	You are the next person who must act.
Your team's turn	A review is requested from a team you are in.
Waiting on others	You did your part. Someone else must act.
Other	Drafts, and threads that only mention you.

Inside a group, the most urgent items come first (failing CI before a comment), then the ones that waited longest. Each item says why it is in its group:

Group	Pull requests	Issues
Your turn	CI failing · Changes requested · Merge conflict · Open review threads · Ready to merge · @alice commented (on your PR) · Review requested · Re-review requested · Assigned to you · New commits since your review	Assigned to you · @alice replied
Your team's turn	Review for acme/web
Waiting on others	CI running · Waiting for review · Waiting on author · You approved · Waiting for a reply · @alice reviewed (with `any_review`)	Waiting for replies · No replies yet · Waiting for a reply
Other	Draft · Bot PR · the section's name	the section's name

The rules are the same as for the inbox's Needs you.

Stale

An item whose turn started more than 3 days ago is stale: it says how long it waited (“waiting 5d”) in amber. Change the number of days with dash.staleDays.

Sections

The sections are tabs above the list: All, then each section with its count. 0 shows all; 1 to 9 show one section. An item can be in more than one section.

The default sections:

Pull requests: Review requested from you, Team review requests, Your PRs, You reviewed, Assigned to you, Mentions you. “Mentions your teams” is off.
Issues: Assigned to you, You opened, Mentions you, You commented. “Mentions your teams” is off.

Change them in Settings → PRs & issues:

Each section has a name and a GitHub search. @me is you. @team runs the search once for each team that you track.
Turn a section off with its switch, move it up or down, delete it, or choose Add section. The link button opens the same search on GitHub, to check it.
Scope is added to every search: for example org:acme, or -repo:acme/website.
Teams lists your teams. Turn off big teams (such as “everyone”) to cut noise. Look up teams again finds new teams at once; otherwise Hush looks every 6 hours.
Defaults puts back the default sections. Nothing changes until you choose Save.

More options are only in settings.json: hide others' drafts (dash.hideOthersDrafts), hide bots' PRs (dash.hideBots), and the stale days.

Actions

Action	Key	What it does
Peek	`Space`	Read it in the peek, and act on GitHub from there.
Main action	`O` or `Enter`	Review, Fix CI, Reply… on GitHub.
Open on GitHub	`Shift + O`	The PR or issue itself.
Hide until it changes	`E`	Hides the item until something new happens on it.
Show hidden items	`H`	Shows hidden items, to show one again.
Copy link	`C`	Copies the links of the item or the selection.
Refresh	`R`	Searches GitHub again now.

Move an item to another group

If Hush puts an item in the wrong group, drag it (by ⋮⋮) to another group or to another place in the list, or use Move to in its menu. The item stays where you put it until it changes on GitHub; then Hush sorts it again. “Moved by you” shows on it; Undo move puts it back. Your order inside a group stays too; new items come in on top.

Select many items to move, hide, or copy them together, the same as in the inbox.

Refresh

Hush keeps the results for 15 minutes, and searches GitHub again when you open the tab after that. Press R to search now. When a search fails, a message says which one; if GitHub needs more access for it (for example an org that has not approved Hush), the message links to GitHub access.