bb-plugins

Eleven plugins for bb, the agent IDE.

Plugin
Declutter	Choose which thread-header controls, composer banners and message actions show, bb's own and every plugin's. Switch one off and it is gone in every window.
Follow Up	Keeps the work an agent noticed but skipped, so nothing is lost when a turn ends. Triage what a thread accumulated above the composer, and answer every thread that needs you from one page.
Mark Unread	Marks a thread unread from any message, as in Slack: from the message's action bar or with Option-click. A New line marks the spot, and coming back scrolls you to it.
Plugin Triage	Decide on plugins one card at a time from a Triage tab in bb's Plugins screen: queue newly published plugins to install, queue pending updates, and clear out plugins you turned off or don't use, then run the queue in the background.
Question Dock	Moves an agent's question out of the chat's way: docked beside the thread on a wide window, floating where you drag it on a narrow one, and as a sheet on a phone.
Side Chats	Keeps a thread's side chats in one list: reopen one after closing its tab, see which have replied, archive them, or promote one to a thread of its own.
Thread Badges	Shows pull-request state, CI attention, listening ports and badges other plugins publish, like Follow Up's progress, on sidebar rows, so you see what needs you without opening a thread.
Thread Summary	A card under the thread header with the thread's branch, its pull request and what other plugins publish about it, like Follow Up's progress. The most urgent sit beside the button as chips.
Swipe Controls	Swipe sidebar threads to mark them read, pin or archive them, and swipe the page with two fingers to go back and forward, with haptic ticks in bb's phone app.
Top Tabs	Opens destinations as tabs across the top of the window, beside a permanent Threads tab, so you can keep several open and switch without losing your place.
Workflow Stages	Files every thread under a workflow stage you define, and moves it as the work progresses. Requires the Ribbon sidebar.

Each is independent. A few soft connections exist and none is required: Thread Badges draws Follow Up's progress ring once you turn it on, and a ports plug when Worktree Ports is installed; Thread Summary draws Follow Up's ring on its card, and its Git and pull-request values can be turned on in Thread Badges too; and Workflow Stages needs Ribbon sidebar to have anywhere to draw.

Install

One at a time, by subdirectory:

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/declutter --tag-prefix declutter/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/follow-up --tag-prefix follow-up/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/mark-unread --tag-prefix mark-unread/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/plugin-triage --tag-prefix plugin-triage/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/question-dock --tag-prefix question-dock/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/side-chats --tag-prefix side-chats/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/thread-badges --tag-prefix thread-badges/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/thread-summary --tag-prefix thread-summary/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/swipe-controls --tag-prefix swipe-controls/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/top-tabs --tag-prefix top-tabs/

bb plugin install "git:https://github.com/matthewdias/bb-plugins.git@*" \
  --subdirectory plugins/workflow-stages --tag-prefix workflow-stages/

Each plugin is released under its own tag prefix, so the range * resolves to the newest release of that plugin alone and these lines never go stale. A caret range would: on a 0.x version ^0.1.0 cannot reach 0.2.0 at all, which is how this page came to offer a plugin two minor versions behind. --plugin <name> works instead of --subdirectory — the repository carries a .bb/plugins.json index naming all eleven.

See each plugin's README for what it does, its settings, and its agent surface.

Development

npm install
npm run check          # typecheck, test, and build every plugin

Per plugin:

npm run typecheck --workspace=bb-plugin-follow-up
npm test --workspace=bb-plugin-follow-up
cd plugins/follow-up && bb plugin install . && bb plugin dev

Requires Node 22 or later and a bb install providing the bb CLI.

License

MIT. See LICENSE.