Repository navigation
Code Review Workspace 1.9.0
Go between a review and its main thread in a click or a key, with the review agent and the main thread in BB's own side panel, and keep one review from your local changes through the PR: it now notices the PR whoever opens it, draft PRs included, and still reviews what isn't pushed yet. Still BB 0.48+ (plugin SDK 0.6.79+) with Node 24+; installs at ^1.0.0 update to 1.9.0. 1.9.0 adds no migration: what it adds to a review is kept with the review's other lifecycle fields. Rolling back to 1.8.1 keeps every review and setting, and 1.8.1 keeps 1.9.0's fields and ignores them. A review merged into another shows in Archive as an archived PR review, empty but for a comment a thread tracks that couldn't move, and its PR's link, bb review <url>, opens that one. One that keeps such a comment is saved without its repo, its link kept, so 1.8.1 lists it as #34, and its Submit, the review agent's tools and the sync refuse it: that comment never posts. Back on 1.9.0, Archive names it by its link again. A review with comments not on GitHub yet opens, but its draft doesn't load and Submit stops before anything posts, so none lands on a wrong line; back on 1.9.0, it loads again. 1.8.1's prune drops Not pushed yet's snapshot, and those comments keep their code.
Doing and reviewing, a click apart
- The review agent and the main thread are tabs in BB's own side panel, as on a thread's page, where they were views of the review's panel: one panel at the right for the conversations, BB's. Ask agent (
a) opens the Review agent tab, and the button closes it again; every way in does too, a line, a selection, a comment, a failing check and Open PR. The Main thread tab, beside a review with one, has the thread's chat, Change thread, and Main thread ↗; it shows while the review loads, and not with Send to thread off. Both are headed by the review's id and name, and show the review you're on, switching as you switch reviews. A BB app from before the side panel opens either chat as a thread in a split instead. Comments and Finish review stay in the review's own panel, beside BB's where they fit and over the code where they don't. - Main thread ↗, in BB's title bar and a phone's dock, goes to the main thread, where it opened the main thread's view; Show beside review, after it, shows the Main thread tab instead. The thread's Review · 2 open ↗, now for whichever review its Review tab shows and straight to it, and the tab's Review ↗ come back; the tab's comments open the review at each, and the agent's first message starts there, on the thread. Links to a thread name it, with ↗: Finish review's, the push notice's and Send's read Main thread ↗.
- Send and Send now toasts have Watch, which shows the main thread beside the review, or on a phone goes to it. Change is Change thread, and Finish review's Change main thread opens the tab with its menu open.
- Switch between review and main thread, in BB's command palette with ⌘⇧. (Ctrl+Shift+.), goes from a thread's page to its review, and from a review's page to its main thread. It's listed only where there's one to go to.
- The review agent's floating widget is gone, with Pop out and Dock: BB's panel docks beside the code on a desktop and an iPad, and covers the page on a phone. A first message you haven't sent stays while BB's panel closes; BB keeps an unsent reply in either chat, as on the thread's own page.
- Beside BB's side panel, a review from 480 to 600px wide, as at BB's default panel width in a 1440px window, keeps BB's title bar and the band, its commands as icons and its title on one line, where it turned into the phone's layout; on a phone's touch screen, 600px still does. Ask agent in full screen leaves full screen, as BB's panel is outside it, and opening a tab closes Comments over the code. While either chat shows, BB's toasts sit above its message box.
- A phone's dock makes way only while you type in the review, not in BB's panel. Its review id is cut from the end, "web:feat/snooz…", where its middle was cut, and its comments to send count those not on GitHub yet too, as the notice does.
- A review agent's chat deleted while it shows says so, with Start a new chat.
One review from local work through the PR
- A folder's review becomes its PR's within seconds, whoever opens the PR: a thread in the folder that pushes, by
git push,git -C <dir> push,jj git pushorgh stack pushorsubmit, or runsgh pr createhas it checked at once, but while GitHub limits reads, Push finds it when the main thread stops, GitHub is read for every local review in one request every 2 minutes, and an open review asks every 30 seconds. A draft PR, a branch a thread in the folder pushed under another name since the review began (git push origin HEAD:feat/nice,gh pr create --head feat/nice), until a push under its own name again (git push -u origin feat/qa,git push origin HEAD), and a PR opened while the guide is being written now count, where they didn't. A PR older than the review, or from another branch, as a stacked branch's upstream before its first push, "PR #12 is frompart1, not this branch.", waits for Make it PR #12's review or Not this one, after which Review actions (⋯) still offers Make it PR #12's review. - The review keeps its notice, "Now PR #4512's review,
api#4512, with 6 comments carried over, 2 not on GitHub yet. It wasapi:snooze-checks, which still opens it.", with PR #4512 ↗ and Got it, where only a page open as it happened said so. Comments the PR's diff doesn't have are sorted then: onto the PR's lines, Not on GitHub yet where only the folder has the line, and the rest kept on the older diff, "1 is on a line the PR doesn't have, under Needs you.", its Needs you opening Comments there. After a merge it says what moved, and Earlier agent chat ↗ opens the merged review's agent chat beside the review. - Its old id keeps working in every command,
bb review api:snooze-checks,ready,comment,summary,askandapprove; an id that names more than one review not archived, as when that branch has a review of its own now, or the same branch's in two folders, names them back, each with its folder, machine and key, "Use one's key or link.", where it took the newest;bb review api:featopens a review by its id, not as a git ref. - The review agent is told without a new turn: its instructions name the PR and the folder, the next message the review sends it, or its review tools' next answer, says so once, and its thread takes the PR's id.
- A folder's review and the PR's own review merge, where they were linked: at once when the one that goes has nothing of yours, else from Merge into one review, the same on both, whose notice says which stays: "PR #4512 has its own review, with 3 comments and a summary. Merging keeps this one and archives that one.", beside PR #4512's review ↗, or on the PR's review Local review ↗. Keep both stops both offering: the folder's review stays local, and the PR's review stays the PR's; while neither is archived, Review actions (⋯) on either still offers Merge into one review, saying which stays. Comments follow their lines with their ids and Sends, a clashing one into the summary, where a thread's report on it still lands, a tracked one's discussion going on in the summary's, and one not on GitHub yet into your notes, and the summary, notes, Sends and viewed files join. The one merged away is in Archive as "Merged into
api#4512", and its page, link or id opens the review it went into. A 1.8.0 linked pair merges the same way, and a second folder on the branch merges into the first's. - The PR's review keeps its folder: "3 files on MaxBook aren't on GitHub yet." with Review them opens Not pushed yet, now a page after the chapters, "Not pushed yet · 3 files" in the navigator, where it was in the Main thread tab: "3 files on MaxBook aren't on GitHub yet", "Branch
feat/x· compared with PR #9 (c0ffee0)", with Refresh, Viewed kept for each file's revision as the chapters keep it, and at its end "Comments here go with Send, not Submit." with Push and Finish review. A comment on a line only there is marked Not on GitHub yet, its status "Draft · goes with Send", and goes with Send, not Submit, as Finish review says, but never to a fixer at the PR's head or with Fix in a new thread, which haven't its line: "1 isn't on GitHub yet: change Main thread to a thread in its folder to send it.", or, with Send comments to the main thread off, "It stays in the draft: turn on Send comments to the main thread in Settings to send it to a thread in its folder.", and moves to its line in the PR after a push. Comments lists it under Not submitted, whose count is what Submit posts, saying "2 aren't on GitHub yet. They go with Send, not Submit." When the PR has new commits, Update, beside Update guide, takes the PR's head without the guide writer, and the guide says it's older, with Rewrite guide: "The guide was written before the PR’s latest commits." once your Push lands, and "The guide was written for the local changes, before the PR." when the PR's diff isn't the folder's. Open in editor opens the folder's files, on its machine. - Push and open PR, in Finish review, pushes a local review whose branch has no PR as Push does, then has the review agent draft the PR for you to post, as the line above it says, with Push only beside it; Open PR alone is for a branch on GitHub already. Once the draft waits in the agent's chat, Finish says "The PR draft is ready." with Post PR…, which opens the Review agent tab, where it is; a toast says it with the same button when Finish isn't showing. A draft it couldn't ask for says why, with Try again. While the draft waits, or after that, Push shows only while the folder has something new to push. With the agent drafting only, a push offers New PR on GitHub ↗. While comments aren't sent yet, Send is Finish's filled button, and Push says "1 comment isn't sent yet. Send it first, or push anyway."; Watch shows only where the agent's chat can sit beside the review.
- A folder's branch renamed, its old branch gone and its last commit on the new one, keeps its review: "Now following
feat/nice. It wasapi:feat/qa, which still opens it." A branch made from it pauses the review, "Folder moved tofeat/x-v2, a new branch. This review stays withfeat/x.", with New review for it and a quiet Follow it instead, where it offered Start a review of it. bb reviewon a branch used again after its PR merged, or closed and went to Archive, starts a new review, where it opened the PR's old one.
Fixes
- A local review's title bar has Finish review too, as a PR's has, counting the open comments Send would send, with no verdict, where only its key and Comments' foot opened it.
- Ask agent with no file in view, in a conversation that had started, said "Couldn’t add that to the chat." It now opens the chat with its box focused.
- A folded comment in a review under 440px wide puts its state on a line of its own, and its severity and first line under it, as on a phone, where with a mouse they shared one line and cut its state to "Draft · go…". One with Not on GitHub yet does so under 600px wide, as beside BB's side panel in a 1440px window, the badge beside its state, "Not on GitHub" under 440px, where from 440px its one line had no room left for its words.