BB Plugins

Focused extensions for BB, kept together in one extensible workspace.

Plugins

	Plugin	Install	What it does
	Taskboard	bb plugin install npm:bb-plugin-taskboard	Brings each BB project's GitHub, Linear, or Jira tasks into one focused List or Kanban board.
	Usage Tracker	bb plugin install npm:bb-plugin-usage-tracker	Keeps Codex and Claude Code 5-hour and weekly limits beside BB's sidebar utility icons.

Taskboard quick start

Install the public package:

bb plugin install npm:bb-plugin-taskboard

Then open Taskboard → Manage, choose a BB project, and select exactly one external tracker for it. Different BB projects can use different providers.

Taskboard keeps rows and Kanban cards compact, preserves each provider's real workflow, opens live issue details, and can send any task to an agent with its context attached. See the Taskboard README for GitHub, Linear, Jira, CLI, and credential setup.

Update or remove it with BB:

bb plugin outdated
bb plugin update taskboard
bb plugin remove taskboard

Usage Tracker quick start

Install the public package:

bb plugin install npm:bb-plugin-usage-tracker

Usage Tracker mounts in BB's native sidebar footer beside the existing utility icons. Each provider gets a compact progress bar and current usage reading. Select Codex or Claude Code to expand its five-hour and weekly limits, reset times, and session status without leaving the current thread. There is no separate plugin page to manage.

The strip refreshes automatically every five minutes, refreshes when a stale BB window becomes active again, and includes a manual refresh control. If a provider is briefly unavailable or rate-limited, the last known limit windows remain visible with the current status. See the Usage Tracker README for requirements, behavior, and development details.

Update or remove it with BB:

bb plugin outdated
bb plugin update usage-tracker
bb plugin remove usage-tracker

Build from source

Each plugin is an independent BB package under plugins/<id>. Clone the workspace once, install the shared dependencies, and register a plugin as a local-path source:

git clone https://github.com/MateoCerquetella/bb-plugins.git
cd bb-plugins
npm install
npm run build
bb plugin install ./plugins/taskboard
bb plugin install ./plugins/usage-tracker

BB reads local-path plugins in place, so the development loop stays short:

git pull
npm install
npm run build
bb plugin reload taskboard
bb plugin reload usage-tracker

BB 0.38 and newer reads the repository's .bb/plugins.json collection, so a plugin can also be installed straight from Git:

bb plugin install git:https://github.com/MateoCerquetella/bb-plugins.git@main --plugin taskboard
bb plugin install git:https://github.com/MateoCerquetella/bb-plugins.git@main --plugin usage-tracker

Each released plugin still gets its own npm package for one-command installs and marketplace updates.

Develop

Run every plugin's checks from the workspace root:

npm install
npm run check

New plugins belong in plugins/<id> with their own package.json, source, tests, pinned @get-bb/plugin-sdk development dependency, and README. Add each directory to .bb/plugins.json; the root npm workspace picks it up automatically.

License

MIT © 2026 Mateo Cerquetella.

Acknowledgements

Repository layout inspired by smsunarto/bb-plugins. Thanks to Scott Sunarto for the clear multi-plugin structure.