Плагины для bb — по одному на директорию в plugins/.
Каждый ставится отдельно, скачивать весь репозиторий не нужно.
| Плагин | Что делает | Статус |
|---|---|---|
| theme-toggle | Кнопка темы в футере сайдбара: клик — переключение день / ночь, наведение с задержкой, удержание или правый клик — меню выбора палитры и режима светлая / тёмная / как в системе. Иконка — квадрат, разрезанный по диагонали из правого верхнего угла в левый нижний: верх день, низ ночь, залитая половина показывает текущую тему; размер вровень с кольцами соседних плагинов | В каталоге bb, релиз theme-toggle/v0.3.0; обновление записи каталога на 0.3.0 (диапазон ^0.3.0, новая иконка и описание) плюс имя автора — PR #110 |
| server-status | Состояние сервера в футере сайдбара: кольцо расхода оперативной памяти вокруг иконки (жёлтое с 80%, красное выше 90%), по клику — окно со сводкой: процессор, память, подкачка, диск, средняя нагрузка, время без перезагрузки, ОС и ядро | Релиз server-status/v0.1.1; заявка в каталог bb — PR #89 |
| usage-meter | Расход лимитов подписки Claude в футере сайдбара: два кольца вокруг иконки — внешнее пятичасовая сессия, внутреннее недельный лимит (жёлтое с 60%, красное выше 85%), лимит по модели с 60% зажигает точку в углу кнопки, по наведению или клику — попап со всеми окнами, временем сброса, планом и почтой аккаунта. Плюс страница «Usage»: та же сводка расхода, что у расширения Claude Code для VS Code (та же формула взвешенной стоимости, те же пороги и формулировки, сутки или неделя), а рядом то, чего в расширении нет, — прогоны workflow и фоновые раны /go, скиллы с весом инструкций, расход по проектам, моделям и тредам bb | Релиз usage-meter/v0.2.3 (чтение лимитов на bb 0.40); в каталоге bb — PR #94, диапазон ^0.2.0 покрывает 0.2.3, правка записи не нужна |
| file-manager | Файловый менеджер машины, на которой работает bb: страницей в сайдбаре, вкладкой правой панели рядом с тредом и пунктом «File location» по правому клику на файловой ссылке в сообщении. Дерево с раскрытием папок на месте и галерея миниатюр, быстрый просмотр по пробелу, свойства с размером папки по требованию, закладки папок, прыжок в рабочую папку треда, отправка файла агенту упоминанием (из меню и из «+» композера), адресная строка для вставки пути, возврат в последнюю открытую папку, загрузка перетаскиванием кусками с докачкой после обрыва (проверено на 5 ГБ), скачивание потоком, перемещение, копирование, переименование, удаление, распаковка архивов; доступ ограничен домашней папкой пользователя, под которым работает bb | Релиз file-manager/v0.7.0; в каталоге bb (PR #90), запись обновляется на 0.7.x в PR #122 |
| context-compact | Кружок контекста под композером становится кнопкой сжатия: клик по нему просит тред сжать контекст — тот же запрос, что делает /compact, — и результат приходит всплывашкой. Наведение не меняется: та же карточка с токенами и остатком. В сплите каждый композер сообщает свой тред, поэтому сжимается тот, чей кружок нажали |
Не выпущен, ставится из ветки @main |
| pdf-viewer | Просмотр PDF внутри bb: любой файл .pdf открывается вкладкой панели вместо скачивания — со страницами, зумом, поиском и печатью, — плюс пункт «PDF» в сайдбаре с обходом папок хоста и списком недавно открытых. Файлы до 25 МБ идут через штатный превью-транспорт bb (работает и для других хостов, и при удалённом доступе), крупнее — потоком с диска сервера с поддержкой докачки по диапазонам |
Релиз pdf-viewer/v0.1.1; заявка в каталог bb — PR #101 |
| voice-ink | Диктовка в композер локальной моделью Whisper на машине bb: без аккаунта, без API-ключа, звук наружу не уходит. Своя кнопка микрофона в композере режет речь по паузам и распознаёт её, пока человек ещё говорит, Escape отменяет запись; плюс плагин регистрирует голосовой AI-сервис bb, поэтому штатная кнопка микрофона тоже оживает (BB_TRANSCRIPTION=voice-ink/local). Модель выбирается в настройках: small — около 2.5 секунды ожидания после фразы, medium — около 7 секунд и заметно точнее (замер на 4 ядрах Xeon без GPU). Модель живёт в памяти между фразами и выгружается после 20 минут простоя |
Не выпущен, ставится из этого репозитория |
bb plugin install git:https://github.com/xMinor-1/bb-plugins.git@^0.2.0 --plugin theme-toggle --tag-prefix theme-toggle/
bb plugin install git:https://github.com/xMinor-1/bb-plugins.git@^0.7.0 --plugin file-manager --tag-prefix file-manager/
bb plugin install git:https://github.com/xMinor-1/bb-plugins.git@^0.1.0 --plugin server-status --tag-prefix server-status/
bb plugin install git:https://github.com/xMinor-1/bb-plugins.git@^0.2.0 --plugin usage-meter --tag-prefix usage-meter/Каждая форма ставит последний релиз по тегу <плагин>/vX.Y.Z и видит
обновления через bb plugin outdated. Форма @main вместо диапазона берёт
текущее состояние ветки — так ставится то, что ещё не выпущено релизом.
--plugin <имя> берёт запись из .bb/plugins.json. Равнозначная форма — через путь:
--subdirectory plugins/theme-toggle.
Локально, из клона репозитория:
bb plugin install path:. --plugin theme-toggleКаждый плагин версионируется отдельно тегом <плагин>/vX.Y.Z:
git tag -a theme-toggle/v0.3.0 -m "Release theme-toggle v0.3.0"
git push origin theme-toggle/v0.3.0Версия в теге должна совпадать с version в package.json плагина. Тег не
переносят и не переписывают — на каждый релиз новый. Пока диапазон в записи
каталога (^0.2.0) покрывает новую версию, обновлять запись в каталоге не
нужно: bb сам увидит релиз. Для версий 0.x смена второй цифры выходит за
диапазон — тогда запись в каталоге правится отдельным PR. Смена источника, названия, иконки или описания —
новый PR в каталог.
scripts/new-plugin.sh <имя> [--app]Создаёт plugins/<имя> и регистрирует его в .bb/plugins.json. Остальные шаги —
в CLAUDE.md.
cd plugins/theme-toggle
npm install
npx tsc --noEmit # проверка типов
bb plugin build . # сборка dist/ (server.js, app.js, app.css + meta)
bb plugin dev . # пересборка и перезагрузка на каждое сохранениеТребования: bb >= 0.39, @get-bb/plugin-sdk >= 0.4.8, Node 24.
dist/ и node_modules/ не версионируются — bb собирает плагин при установке
из git сам.
MIT — см. LICENSE.