Super Diff

Daniel BachhuberCode & Reviews
Get it for macOS

Read a long diff one concern at a time, with each group explained and notes under the lines a reviewer might misread. Click Generate Super Diff in the Diff tab, and the thread's agent groups the changed files into concerns in place of bb's file list, with a line on what each file's change does. Hover any other line, removed ones included, and click Explain this line for a note written on request. Each file keeps bb's Viewed checkbox, each concern counts its viewed files, and the list offers Regenerate when files change after it was written. Requires bb 0.47 or later; generating sends one message to the thread's agent.

Overview

View source

What you get

  • A Generate Super Diff button that asks the thread's agent to sort the changed files into concerns. The grouped list takes the place of bb's file list, and Super Diff | Original switches back.
  • A line under each concern for every file, saying what its change does, and bb's Viewed checkbox on each file, with a count of viewed files per concern.
  • Notes in the diff under the lines a reviewer might misread, removed lines included, and an Explain this line button on any other line for a note written on request.
  • An amber Out of date warning with Regenerate when files are added or edited after the Super Diff was written.

How it works

The agent reads the diff with bb super-diff read and stores its grouping with bb super-diff submit, which checks that every file is placed exactly once. Super Diff keeps one per thread and diff on this machine and calls no outside service. Explain this line asks a hidden side chat of the thread, so the thread's agent is not interrupted.

For agents

The super-diff skill tells an agent to run bb super-diff read and follow the guide it prints. An agent can write a Super Diff at the end of its own work without anyone pressing Generate.

Requirements

A thread with a git environment, and bb 0.47 or later for the Viewed checkboxes. Nothing to configure.

More from Daniel Bachhuber

Automation PaletteRun any bb automation from the quick palette, without opening the Automations page. Each row names the automation and its project, so typing either name finds it, and selecting it starts the run as its schedule would. Every project's automations are listed in every window, and a paused automation keeps its row. Requires bb 0.42 or later and the bb CLI on the machine running the bb server.3Diff Viewed EnhancedSee how much of a long diff you've read, with a viewed count beside bb's own Viewed checkboxes and the same marks on GitHub. The changes panel toolbar counts the files you have checked, such as 3/6 viewed, across every file in the range. On a thread with an open pull request, checking a file in bb marks it viewed on GitHub, and a file marked viewed on GitHub is checked in bb. A file with edits you have not pushed shows a Local icon until a push makes its diff match the pull request's. Requires bb 0.47 or later, and GitHub sync needs the gh CLI signed in.22Impromptu UITurn your agent's walls of text into interfaces you can click. Triage a milestone from rows that each carry a drafted comment and Post and close, Post, and Start thread buttons. Split one review comment into several pull requests, each waiting on its own card with its diff until you click Commit, push, and open PR. Find a design by picking from screenshots of the original and its variations, with a note on each. Requires bb 0.43 or later, and needs no account or external service.NewMarkdown EditorEdit a markdown file in the tab you were already reading it in, and save it with Cmd+S. Preview renders the file the way bb renders a chat message, including the images it points at, and Raw gives you the source in an editable pane, with unsaved text carrying between the two. Selecting text in Preview offers an Add to chat button that quotes it into the composer under the file's path. A pencil on markdown files in the changes panel opens the one you are reading a diff of. Every save checks the file's hash first, so an edit an agent made while you were typing gives you a choice between reloading and overwriting instead of a silent clobber. Works on files in a project workspace, on a host, or in a thread's storage. Requires bb 0.43 or later, and needs no account or external service.13

More in Code & Reviews 48

Work with repositories, builds, changes, pull requests, issues, and reviews.

View all