Build, install, and debug bb plugins. Use when the user wants a bb plugin, a sidebar panel, a bb CLI subcommand, an agent tool, a theme, a provider, or to extend bb itself. For running threads and the core bb CLI, use bb-cli instead.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
bb plugins are TypeScript packages that run inside bb. They are how bb extends itself.
Many first-party features are plugins: GitHub, Docs, Memory, Tasks, Connect, Automations, Secrets, Keep Awake, and the coding-agent providers.
Plugins are full-trust. Server code runs in-process. App UI is same-origin page code, not a sandbox. Host workers run as Node on enrolled machines.
Review source before installing third-party plugins. Keep credentials in secret: true settings.
bb-cli to operate bb (threads, projects, environments).bb-plugin-authoring skill if it is available, then run bb guide plugins. In the plugin directory, run bb plugin types before trusting local SDK types. Do not guess from minified dist/ files.bb plugin new hello # add --app for a React UI
cd bb-plugin-hello
bb plugin install . --yes
bb plugin dev # rebuild + reload on save
The manifest is the bb object in package.json. Required: bb.name, bb.description, bb.branding.icon, bb.server. Optional: bb.app, bb.host, bb.skills, bb.themes.
Plugin id is the last package-name segment with a bb-plugin- prefix stripped. bb-plugin-hello and @acme/bb-plugin-hello both become hello.
Put runtime imports in dependencies. Leave types and tooling in devDependencies. Git installs run npm install --omit=dev.
A default-export factory in server.ts receives BbPluginApi and registers surfaces:
bb <name> … commandskills/ folders, extra instructionsapp.tsx default-exports definePluginApp and can add pages, thread-panel actions, composer controls, file openers, and a replacement sidebar.
Do not copy the full API into this skill. Read bb-plugin-authoring when implementing a surface.
bb plugin install . # local path
bb plugin install github # bundled official plugin
bb plugin install npm:bb-plugin-notes@^1.0.0
bb plugin install git:https://github.com/acme/bb-plugin-notes.git@^1.2.0
bb plugin list
bb plugin reload <id>
bb plugin logs <id> -f
Installs prompt because the code is full-trust. Pass --yes to skip.
A failed managed update rolls back. Catalog refresh never installs code.
Community listings live at https://getbb.app/marketplace/v1/marketplace.json. Submit via a PR to https://github.com/get-bb/marketplace. Use the submit-a-plugin skill for that workflow.
bb plugin list shows the plugin running.bb <command> --help works.error. Read bb plugin logs <id> and fix, then bb plugin reload <id>.No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Pull 16 fast decisions out of the user with 4 sets of 4 open questions, then present an implementation plan. Only for risky changes, large product decisions, or large refactors. Run when the user types /4x4. Agents may suggest it in one line but never start it on their own.
The English summary is being prepared. Showing the original description.
Record concise ADRs that preserve the user's decisions without conversational noise. Use for "adr-verbatim", "new ADR", "document that as an ADR", "record this decision", or supplied ADR wording.
The English summary is being prepared. Showing the original description.
Keep a Mac awake for a set duration or while a process runs. Use only when the user explicitly invokes /anti-sleep.
The English summary is being prepared. Showing the original description.
Clarify a feature, change, or refactor through questions, then write a build prompt for another agent. Use for /ask-then-build or requests to ask questions before producing an implementation prompt.
The English summary is being prepared. Showing the original description.
Use this when controlling bb. The bb CLI inspects and manages threads, environments, projects, machines, providers, skills, plugins, settings, terminals, and other BB services.
The English summary is being prepared. Showing the original description.
Fire the moment the user proposes a build. Instantly surface the 1-3 consequential choices hidden in their idea. Can also be invoked with /before-building.
The English summary is being prepared. Showing the original description.