Skip to content

App-wide scripts

bb 0.43.3SDK 0.4.104pinned e865697 (desktop-v0.43.3)

stable The bb app window #16 in group Show on the zone map

Runs your code inside the bb window itself, without rendering a UI of its own. With this, a plugin can:

What it gives you

  • Mount once per bb window and unmount when the window reloads
  • Add behavior that is not tied to one screen, such as a keyboard shortcut
  • Set a thread row status on any thread, for as long as the script is mounted
  • Add plugin-owned elements to app pages without taking ownership of bb's built-in layout
  • Return a cleanup function. bb calls it once on unmount, and clears any row statuses the script set

API

Each symbol links to the pinned commit it was read at.

The brief is Markdown, written for a coding agent: what the capability is, where it registers, every SDK symbol with a pinned permalink, the rules that bite, and what done means.