💻 Tech-радар: BB изнутри: как устроена открытая IDE для Claude Code и Codex, которая обновляет плагины без перезапуска
Открытая программа BB под лицензией MIT собирает Claude Code, Codex, Pi и ACP-агентов в одном окне: за 7 месяцев репозиторий get-bb/bb собрал около 4 тысяч звёзд. Главное в BB не само окно, а то, что его интерфейс достраивается плагинами, и новый плагин подхватывается без перезапуска программы. В демонстрационном ролике агент за 20 минут и два промпта собрал плагин, который расшифровывает запись созвона, выделяет договорённости со сроками и пишет письмо клиенту. Разбор кода проверен по репозиторию get-bb/bb по состоянию на конец сентября 2026.
Идея BB держится на двух слоях: снизу — агенты, которые у пользователя уже есть, каждый в своей обвязке, сверху — одно окно, которое с ними разговаривает. Команда npx bb-app запускает лаунчер, а тот поднимает два Node-процесса: server и host-daemon. Сервер написан на Hono, по умолчанию слушает 127.0.0.1:38886 и хранит всё состояние в SQLite в файле ~/.bb/bb.db, а демон держит примитивы машины — файлы, git, терминалы и запуск агентов. Десктопное приложение на Electron здесь только оболочка: оно запускает тот же bb-app и показывает веб-интерфейс сервера. Связь идёт в непривычную сторону — не сервер ходит к демону, а демон сам открывает к серверу WebSocket и получает по нему команды вроде turn.submit. Поэтому вторая машина подключается к BB без открытых портов: в настройках генерируется однострочник curl .../install.sh, он ставит демон как сервис launchd или systemd, и демон получает свой ключ машины. Сервер при этом — роль, а не отдельный компьютер, и на серверной машине работает такой же демон, как на остальных. Протокол между демоном и сервером версионирован: сейчас в контракте стоит HOST_DAEMON_PROTOCOL_VERSION = 220, и если версии разошлись, демон сам скачивает подходящую сборку, сверяет её SHA-256 и перезапускается — обновлять вторую машину руками после каждого релиза сервера не нужно.
Клиентов у сервера может быть несколько: веб-интерфейс на React 19, окно Electron, CLI bb, SDK и мобильное приложение на Expo. Все они ходят в один и тот же /api/v1, поэтому тред, начатый в браузере, продолжается с телефона или из терминала. Тред хранится как журнал: таблица events только дописывается, и у каждого события есть номер sequence внутри треда. Когда демон присылает новую пачку событий, сервер вставляет их и рассылает по WebSocket одно уведомление changed; самих данных в WebSocket нет, поэтому клиент помечает своё состояние устаревшим и дочитывает таймлайн по HTTP. Схема «уведомил, потом дочитал» проще потоковой, потому что у клиента нет своей копии треда, которая могла бы разойтись с сервером.
Разные интерфейсы агентов BB приводит к общему виду через собственный provider bridge protocol. Демон запускает для каждого агента отдельный процесс-мост и общается с ним по JSON-RPC 2.0 через стандартный ввод и вывод; мост входит в плагин провайдера, демон скачивает его с сервера и перед запуском сверяет хэш. BB построен не поверх ACP от Zed: ACP здесь лишь один из диалектов, которые мосты переводят в собственный протокол — так запускаются cursor-agent acp, opencode acp, hermes acp и другие. Нормализация идёт в два шага: сначала мост переводит родной поток агента в небольшой набор событий (открыть ход, открыть элемент, дописать текст, закрыть элемент, сообщить расход токенов), потом ассемблер внутри демона сам выдаёт идентификаторы ходов и элементов, следит за жизненным циклом и склеивает поток токенов окнами по 100 мс. Документация описывает разделение фразой «the bridge knows the dialect, the runtime knows the timeline»; подп
Категория: Технологии
Теги: #Технологии #Tech #IT #Искра