GitHub Folder
The open GitHub pull requests that need you, as a folder at the top of the sidebar: review requests, then your own PRs with changes requested, failing checks or conflicts, and the ones ready to merge. Click a PR to start a thread with its title, status, branch and description as context, in the project whose remote is that repository. Snooze a PR until it changes, and pick sources, drafts and organizations. Reads GitHub through the gh CLI on the bb server; Thread Tree draws the folder in its own list when installed.
Overview
View sourceThe open GitHub pull requests that need you, as a folder at the top of the sidebar.
What you get
- Review requests first, then your own PRs that wait on you: changes requested, failing checks, conflicts, or approved with nothing blocking the merge. PRs assigned to you or mentioning you can join them.
- Each row shows the PR title and a short reason in colour. A click opens a page with the PR as a context card (title, status, branch, description) above bb's new-thread composer, in the bb project whose git remote is that repository. Type the question and send: the agent gets the PR context with it, and the chat shows only what you typed. ⌘-click or the arrow on hover opens the PR on GitHub; hover also shows its number and a snooze button that hides it until the PR changes.
- The GitHub entry in the navigation rail opens the same page with the folder's PRs to pick from.
- The customize button in the folder header picks what is listed: review requests with or without team requests, your PRs only when they need you or all of them, assigned, mentions, drafts, and which organizations to show. It also refreshes and shows which gh accounts are read.
- The arrow button opens GitHub's pull requests page.
- The folder sits above bb's own thread list, in that list's style. With the Thread Tree plugin's list, Thread Tree draws the folder in its own style instead, with the same settings.
bb github-folder listprints the folder in a terminal.
How it works
The bb server runs one GraphQL search through the gh CLI for every gh login on that machine
(the default one and each ~/.config/gh-* profile) in the background and on refresh. Only GitHub
sees those requests. Settings and snoozes are stored in the plugin's storage on the bb server, so
every client shows the same folder.
Requirements
The gh CLI, signed in on the bb server machine.
More from Dmitrii Maksimov
More in Code & Reviews 61
Work with repositories, builds, changes, pull requests, issues, and reviews.


