bb — агентная IDE, которая строит сама себя: установка и быстрый старт

bb — бесплатная агентная IDE с открытым кодом (лицензия MIT), которая умеет управлять, изменять и автоматизировать саму себя. Она запускает coding-агентов вроде Claude Code, Codex и Cursor в единой локальной среде: работа идёт в тредах (рабочих сессиях агента), а управлять ею можно через десктопное приложение, веб-интерфейс, командную строку (CLI) и HTTP API.

Оглавление:

1. Что такое bb
2. Основные возможности
3. Что нужно для установки
4. Установка и первый запуск
5. Подключение провайдеров
6. Полезные сценарии
7. Проверка результата
8. Ограничения и когда bb не подходит
9. Тарифы и лимиты
10. Ссылки

Что такое bb

bb (сайт getbb.app, репозиторий get-bb/bb) — локальная среда разработки, построенная вокруг ИИ-агентов. Авторы называют её «IDE, которая строит сама себя»: почти любую часть интерфейса и функциональность можно изменить одним промптом, а многие штатные функции, включая интеграцию с GitHub, память агента, отложенные задачи и удалённый доступ, реализованы как плагины, созданные теми же инструментами, что доступны пользователю.

Ключевые свойства:

• Все поверхности равноправны: десктопное приложение, веб-приложение, CLI и HTTP API.
• Работа организована в треды: за выполнением можно следить в реальном времени, вмешаться в любой момент или передать тред другому агенту.
• Локальный запуск: bb работает на вашей машине и использует подписки провайдеров, которые вы уже оплачиваете.
• Лицензия MIT: репозиторий можно форкнуть и развернуть собственную сборку для команды.

Проект в активной разработке: базовая архитектура стабильна, но рабочие процессы и интерфейсы ещё меняются. Репозиторий создан в феврале 2026 года, на момент проверки (1 сентября 2026) у него около 2 650 звёзд и 316 форков. На сайте среди команд, которые используют bb, названы Meta, Figma, Notion, Datadog и другие.

Основные возможности

Что нужно для установки

• Node.js версии 22.19, 24 или 26.
• Git.
• Хотя бы один поддерживаемый CLI-провайдер: Claude Code, Codex, Cursor (через ACP — Agent Client Protocol, протокол подключения внешних агентов), Pi, OpenCode, Grok Build или Hermes Agent. Если провайдер уже установлен и авторизован, bb подхватит существующие учётные данные.

Поддерживаемые платформы: macOS (десктопное приложение для Apple Silicon), Linux (AppImage в статусе альфа-версии) и Windows через WSL2 — все процессы bb должны работать внутри дистрибутива WSL2, нативные PowerShell и CMD не поддерживаются. На Mac с процессором Intel используйте запуск через npx.

Установка и первый запуск

Вариант 1 — десктопное приложение (рекомендуется). Скачайте свежую сборку со страницы релизов на GitHub (тег desktop-latest) и установите как обычное приложение macOS. Для ранних пользователей есть nightly-канал: еженочные сборки ставятся рядом со стабильной версией, с отдельной жёлтой иконкой и своим каналом обновлений.

Вариант 2 — запуск из терминала через npx:

npx bb-app@latest

После запуска откройте http://localhost:38886. Для новейшей автоматической сборки используйте npx bb-app@nightly.

Команда скачивает пакет bb-app, запускает сервер и локальный фоновый процесс и отдаёт веб-интерфейс. Данные bb хранятся в каталоге ~/.bb/. Если bb запущен в другом терминале или в фоне, остановить его можно командой:

npx bb-app stop

Подключение провайдеров

Отдельные ключи для самого bb не нужны: он использует CLI-провайдеров, которые у вас уже настроены.

Если провайдеру нужен API-ключ, безопасное место для него — файл окружения bb (~/.bb/env.json):

npx bb-app env set OPENAI_API_KEY <ваш-ключ>

Команда npx bb-app env list показывает список переменных, скрывая значения.

Полезные сценарии

Сценарий 1. Разобрать инцидент в фоне

Задача: в мониторинге всплеск ошибок, нужно быстро понять причину, не отвлекаясь от текущей работы. Условие: проект открыт в bb, выбран провайдер. Что делать: создайте тред с формулировкой вроде «разбери всплеск ошибок в Sentry» — в демонстрации на сайте bb агент в таком треде исследует файлы, находит, что 92% ошибок даёт обращение к пустому cart в функции applyPromo, добавляет защиту от пустого значения и регрессионный тест. Результат: в рабочем дереве видны изменения и повторный прогон тестов, тред остаётся в сайдбаре. Ограничение: агент действует в рамках прав, которые выдали провайдеру; деструктивные операции контролируйте сами.

Сценарий 2. Достроить среду под себя одним промптом

Задача: нужен трекер задач прямо в IDE. Условие: любой открытый проект в bb. Что делать: попросите bb добавить управление задачами — bb соберёт плагин, зарегистрирует панель в сайдбаре, команду bb tasks и навык, который научит всех агентов этим трекером пользоваться. Результат: новая панель и команда доступны сразу, без пересборки приложения. Ограничение: сгенерированный плагин — такой же код, как любой другой: перед тем как положиться на него в важном процессе, проверьте его работу.

Сценарий 3. Ставить задачи агентам из внешних систем

Задача: запускать работу, пока вас нет у компьютера, — из скрипта, cron-задания или собственного бота в Telegram, Signal или Slack. Условие: запущенный сервер bb. Что делать: внешний процесс вызывает CLI или Node SDK и создаёт тред:

import { BBSdk } from "bb-app";

const bb = new BBSdk();
const thread = await bb.threads.spawn({
  projectId: "proj_personal",
  environment: { type: "host", workspace: { type: "personal" } },
  prompt: "Почини падающий CI в main",
});

Результат: тред появляется в сайдбаре и ждёт вас, работа выполняется локально на вашей машине. Ограничение: у HTTP API bb нет встроенной авторизации, поэтому сетевой доступ настраивайте только через доверенную сеть — подробнее в разделе об ограничениях.

Проверка результата

Минимальный рабочий сценарий после установки:

1. Выполните npx bb-app@latest. Признак успеха: в терминале печатаются адреса запущенного сервера, ошибок нет.
2. Откройте http://localhost:38886. Признак успеха: загружается веб-интерфейс bb.
3. Добавьте или откройте проект и создайте тред, выбрав провайдера.
4. Дайте простую задачу, например попросите объяснить структуру репозитория. Признак успеха: тред переходит в рабочее состояние, агент отвечает и показывает выполненные действия.
5. Проверьте CLI: npx --package bb-app bb --help должен вернуть список команд.

Если запуск падает с ошибкой Could not locate the bindings file, вернитесь к предупреждению про npm 12 в разделе установки.

Ограничения и когда bb не подходит

• Проект в активной разработке: рабочие процессы и интерфейсы меняются между версиями. Для стабильности используйте основной канал, а не nightly.
• Linux-сборка AppImage имеет статус альфа-версии; Windows поддерживается только через WSL2.
• Сервер bb не имеет встроенной авторизации и допускает выполнение команд и чтение файлов. Для доступа с других устройств используйте bb connect или Tailscale Serve и не открывайте порт 38886 в недоверенной сети.
• Десктопное приложение и npx-запуск отправляют анонимную телеметрию: запуски приложения, счётчики тредов и сообщений, без содержимого сообщений и данных проектов. Отключить можно переменной окружения BB_TELEMETRY=false.
• bb не заменяет подписку на модель: без хотя бы одного настроенного провайдера среда не заработает.

Тарифы и лимиты

Сам bb бесплатен и распространяется по лицензии MIT, включая коммерческое использование и форки. Платите вы только за подписки провайдеров (Claude, ChatGPT/Codex, Cursor и других) по их собственным условиям. Дата проверки: 1 сентября 2026 года; актуальные условия смотрите на getbb.app и в репозитории.

Ссылки

• Сайт: https://getbb.app/
• Репозиторий: https://github.com/get-bb/bb
• Документация пакета и установки: packages/bb-app в репозитории
• Поддержка платформ: docs/platform-support.md в репозитории
• Сообщество: Discord (ссылка на сайте)

Следующий шаг

Если вам близка тема параллельной работы нескольких coding-агентов, посмотрите материал про смежный инструмент: Orca — среда для параллельной работы с Codex, Claude Code и другими coding-агентами

Связанные материалы

• Статья: Редакция pimenov.ai на Codex app-server: архитектура собственного агентного приложения
• Блог: OpenClaw 2.0 вышел: что важно в крупнейшем релизе проекта
• База знаний: codex app-server — как встроить Codex в собственное приложение

bb показывает понятный паттерн: агентная среда, которую команда перестраивает под свои процессы, а задачи агентам ставятся из любых систем. Если вы подбираете такую архитектуру для своей разработки, обсуждение может быть полезным.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov