This repository contains independently maintained plugins for bb. Each plugin is a self-contained package that can contribute server behavior, UI, commands, and agent skills.
plugin-browser adds a per-thread Chrome browser to bb. Users and agents share
the same session through the side panel, the bb browser command, or Chrome
DevTools Protocol.
plugin-codex-environments lets bb use Codex-compatible
.codex/environments/*.toml files for worktree setup, cleanup, and services. It
also contributes a provider-neutral skill that teaches agents to maintain those
files.
Codex Environments documentation
plugin-stay-awake blocks macOS idle sleep while bb runs, so agents keep
working and bb connect stays reachable. The display still sleeps on its own
schedule, and closing the lid still sleeps the machine.
Clone the repository, install the selected package's dependencies, then install that directory into bb:
git clone https://github.com/jssblck/bb-plugins.git
cd bb-plugins/plugin-codex-environments
npm install
bb plugin install . --yesUse plugin-browser instead to install the browser plugin.
Run checks from the plugin directory. Each package documents its own commands and runtime behavior in its README.
Everything committed here is public. Do not commit credentials, private data, private code, internal URLs, local machine details, or content copied from a private source. See AGENTS.md for the required pre-push checks.