Get started
- Sign in with GitHub. Signing in only tells Sheaf who you are.
- Install the Sheaf GitHub App on your personal account and pick the repositories it may read.
- Sheaf syncs the open issues, pull requests and alerts of those repositories. After that, GitHub webhooks keep the inbox current within seconds.
Add an organization
Open Settings, then GitHub accounts, and choose Add account. GitHub asks which account to install the app on. Each organization is a separate install with its own repository list.
If you are not an owner of the organization, GitHub sends your request to its owners. The organization appears in Sheaf after an owner approves the install.
Choose repositories
On the install screen you pick all repositories or only some. To change the list later, open the app in your GitHub settings under Applications, or in the organization settings under GitHub Apps. Manage next to each account in Settings opens that page. Sheaf removes the rows of a repository you take away.
The sync button next to an account fetches it again. You can sync up to 10 times a minute. If a sync fails, the account shows the error that GitHub returned.
Read the inbox
- Inbox lists every open issue, pull request and alert across your accounts, most recently updated first.
- Security groups the alerts by package and shows which upgrade closes the most of them. The Alerts tab lists the alerts from Dependabot, code scanning and secret scanning, with critical and high first.
- Sent lists the open pull requests and issues you opened on GitHub.
- Repos shows the open issues, pull requests and alerts of each repository.
- This week counts the pull requests you merged, the issues you closed and the reviews you gave in the last 7 days.
- Pick an account in the sidebar to see only its rows.
- On a wide screen, press [ to collapse the sidebar to icons, and again to open it.
- Press / to search titles and repositories on Inbox, Sent, Security and Repos.
- Mute an account or a repository in Settings, then Inbox, and its rows stay out of every list until you unmute it.
- Settings, then Inbox, also sets the lowest alert severity that Sheaf shows.
- Hide bots, on by default, drops rows opened by accounts whose name ends in [bot], such as Dependabot pull requests. Sheaf remembers the choice, from the kind menu or Settings.
- A row leaves the inbox when it closes on GitHub, or when you mark it done or snooze it. Sheaf never closes or changes anything on GitHub.
Clear the inbox
- Done (e) takes a row out of the inbox. If anything new happens to it on GitHub, it comes back.
- Snooze (h) hides a row until 9:00 tomorrow or next Monday. Change the hour and the day in Settings, then Snooze and done.
- Mark done when opened, in the same place, marks a row done when you open it on GitHub.
- Read (u) toggles the dot that marks a row with news since you last opened it.
- Pick several rows with x, then mark them done or snooze them together. Every change shows Undo for a few seconds.
- Done and snooze live in your Sheaf account, so they follow you to any device. GitHub does not see them.
What For you shows
For you lists the issues and pull requests assigned to you, and the pull requests where someone asked for your review. A review request to one of your teams does not count, because it does not name you.
In Settings, then Inbox, you can turn each reason off, and add critical security alerts to For you.
Keyboard shortcuts
The keys work anywhere in the inbox except while you type in search. Press ? to see them in Sheaf.
| Key | Action |
|---|---|
| j or ↓ | Next item |
| k or ↑ | Previous item |
| ↵ or o | Open the item on GitHub |
| c | Copy the link to the item |
| Esc | Back to the list on a small screen |
| e | Mark done, or move back to the inbox |
| h | Snooze until tomorrow or next week |
| u | Mark read or unread |
| x | Pick the item for a bulk action |
| Esc | Clear the picked items |
| ⌘ + K | Command menu: a place, an account or an item |
| 1 | For you |
| 2 | All open |
| 3 | Security alerts |
| g then i | Go to Inbox |
| g then s | Go to Sent |
| g then f | Go to Security |
| g then r | Go to Repos |
| g then w | Go to This week |
| [ | Collapse or expand the sidebar |
| j or ↓ | Next row |
| k or ↑ | Previous row |
| ↵ | The main action: open on GitHub, or open the repo in the inbox |
| e | Mark done in Sent, or mark an upgrade as planned |
| c | Copy the upgrade command |
| o | Open the repo on GitHub |
| / | Search titles and repos |
| Esc | Leave the search box |
| ? | Show this list |
Settings
- Open Settings from the menu under your name, or press ⌘K and type Settings. Esc closes it.
- General sets the theme, light, dark or the same as your device, and the time zone for the greeting and This week. Both stay in this browser.
- Inbox, Snooze and done keep their choices in your Sheaf account, so they follow you to any device.
- Profile lists the devices where you are signed in. Sign one out, or every other device at once.
Free and Pro
Free shows one account: the one you installed first, or the one you pick in Settings, then Plan. You can change the pick once every 30 days. Other accounts stay connected with a lock in the sidebar. Sheaf does not fetch them or keep their updates, apart from the merges, closes and reviews that This week counts. An account is fetched in full when you pick it or upgrade. Pro shows every account. See pricing for the prices.
Upgrade, change your card or cancel in Settings, then Plan. Plan also lists every payment with a link to its receipt. Manage billing opens the Polar customer portal.
Remove your data
- Uninstall the app on GitHub, and Sheaf deletes that account and every row it stored for it.
- To get a copy of your data, open Settings, then Profile, and choose Export JSON.
- To delete your Sheaf account, open Settings, then Profile, and choose Delete account. Cancel Pro first if you have it.