ariofrio's bb plugins

Plugins for bb, the agent IDE that builds itself

Organization	Navigation	Themes
Thread stages Groups sidebar threads into drag-ordered stages that update as they run	Project breadcrumbs Adds the current project and its actions menu before each thread title	ChatGPT theme Matches bb's palette to the OpenAI ChatGPT (née Codex) desktop app, light and dark
Project icons Gives each project an icon and optional color, in the thread header and sidebar	Missing keyboard shortcuts Adds shortcuts for threads, history, the composer, side chats, and terminals

Install

Add this repository as a bb marketplace, then choose any of its plugins in Settings → Plugins:

bb marketplace add git:github.com/ariofrio/bb-plugins@main

The marketplace tracks each plugin's Git release tags, so new releases appear without re-adding it. Its catalog is defined in marketplace.json.

To install one plugin directly from main, follow its README, or select it from the repository's plugin collection:

bb plugin install git:https://github.com/ariofrio/bb-plugins.git@main --plugin chatgpt-theme

The available collection names are listed in .bb/plugins.json. Nothing here is published to npm yet.

Development

Clone the repository and install every plugin at once:

git clone https://github.com/ariofrio/bb-plugins.git
cd bb-plugins
npm run install:plugins

Run the same command after a git pull: it installs whatever is missing, then rebuilds and reloads every plugin.

Releases

Create a Changeset with npm run changeset for every user-visible plugin change. After the change reaches main, automation opens or updates a release pull request with version, lockfile, and changelog updates. Merging that pull request validates the affected plugins, creates immutable <plugin-id>/vX.Y.Z Git tags, and publishes a GitHub release per tag carrying that version's changelog entry. Every listing accepts any released version, so the catalog never changes with a release.

npm run release:check runs each plugin's tests, type checks, build, SDK declaration verification, and packed artifact verification. CI runs the same check for every plugin. Build output in dist/ is generated and is not committed.

License

MIT