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

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

Оглавление:

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

Что такое bb

bb — локальная среда разработки, построенная вокруг ИИ-агентов. Авторы называют её «IDE, которая строит сама себя»: интерфейс и функции можно расширять плагинами, а новые панели, команды и навыки создавать с помощью тех же агентов, которыми управляет пользователь.

Работа организована в треды — отдельные сессии агента. За выполнением задачи можно следить в реальном времени, отправлять уточнения во время работы, ставить следующие сообщения в очередь или передавать задачу другому агенту.

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

• веб-приложение, десктопный клиент, CLI, Node SDK и HTTP API работают с одними тредами;
• поддерживаются Claude Code, Codex, Cursor, Pi, OpenCode, Grok, omp (oh-my-pi) и Hermes;
• агенты используют настроенные на машине подписки и учётные данные провайдеров;
• основные функции, включая GitHub-интеграцию, память, автоматизации и удалённый доступ, реализованы как плагины;
• проект распространяется по лицензии MIT и допускает собственные сборки.

Проект активно развивается, поэтому интерфейс, команды и рабочие процессы могут меняться между выпусками. На момент проверки 8 сентября 2026 года в официальном репозитории было около 3,4 тысячи звёзд и 425 форков. Актуальный changelog начинается с версии 0.42.0.

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

Что изменилось в версии 0.42.0

Выпуск 0.42.0, актуальный на дату проверки, добавил несколько заметных функций:

• экспериментальный Account Pooler для нескольких аккаунтов Claude и Codex: прокси автоматически переключает аккаунты при достижении лимитов использования;
• push-уведомления для мобильного, веб- и десктопного клиентов;
• обновлённый каталог плагинов с категориями и официальной коллекцией;
• центр пропущенных уведомлений;
• команду /clear и bb thread clear в незанятом треде для сброса контекста агента с сохранением истории и рабочего пространства;
• настройку префикса веток для управляемых рабочих деревьев (worktree);
• улучшения очередей сообщений, восстановления соединений и запуска Linux AppImage.

Account Pooler пока отмечен как экспериментальный. Не стоит использовать автоматическое переключение аккаунтов в критичном процессе без предварительной проверки его поведения и условий провайдеров.

Требования и поддерживаемые платформы

Для запуска через npm нужны:

• Node.js 22.19 или новее в ветке 22, либо протестированные Node.js 24 LTS или Node.js 26 Current;
• Git;
• хотя бы один установленный и авторизованный провайдер командной строки: Claude Code, Codex, Cursor через ACP (Agent Client Protocol, протокол подключения внешних агентов), Pi или другой совместимый с ACP агент.

Поддерживаемые среды:

• macOS — постоянный хост и десктопное приложение;
• Linux — постоянный хост; десктопная сборка x64 AppImage имеет статус Alpha;
• Windows — Ubuntu в WSL2.

На Windows все процессы bb, Node.js, Git и CLI-провайдеров должны находиться в одном дистрибутиве WSL2. Команды запускайте из Linux-терминала. Нативные PowerShell, CMD, пути с буквами дисков и UNC-пути не входят в поддерживаемый сценарий.

Репозитории внутри файловой системы WSL работают надёжнее. Пути /mnt/c/... поддерживаются, но операции с файлами и отслеживание изменений там могут быть медленнее.

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

Запуск через npx

Выполните:

npx bb-app@latest

Затем откройте:

http://localhost:38886

Команда скачивает опубликованный пакет bb-app, запускает сервер и локальный фоновый процесс (host daemon), после чего поднимает веб-интерфейс. Состояние bb по умолчанию хранится в каталоге ~/.bb/.

Остановить процессы в текущем терминале можно через Ctrl+C. Если bb работает в другом терминале или в фоне, используйте:

npx bb-app stop

Для нестабильных автоматических сборок есть отдельный канал:

npx bb-app@nightly

Nightly собирается из основной ветки и обновляется независимо от стабильного тега latest. Для обычной работы лучше использовать стабильный канал.

Десктопное приложение

Актуальную сборку для macOS можно скачать с официального сайта или из репозитория bb. Linux AppImage остаётся альфа-версией, поэтому для Linux и удалённых машин предсказуемым стартовым вариантом остаётся npx bb-app@latest.

npx --allow-scripts=better-sqlite3,node-pty,@parcel/watcher bb-app@latest

Правило можно сохранить для последующих установок:

npm config set allow-scripts=better-sqlite3,node-pty,@parcel/watcher --location=user

Если ошибка появилась после смены версии Node.js, переустановите пакет или пересоберите нативную зависимость, например:

npm rebuild better-sqlite3

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

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

Секреты провайдеров можно хранить в ~/.bb/env.json. Безопаснее вводить значение через интерактивный запрос, чтобы ключ не остался в истории команд:

npx bb-app env set OPENAI_API_KEY

Проверить наличие переменных без вывода их значений:

npx bb-app env list

OPENAI_API_KEY нужен только для маршрутов, которые явно используют OpenAI API. Стандартные Codex-маршруты могут работать с учётными данными Codex CLI.

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

Разобрать инцидент в отдельном треде

Задача: исследовать всплеск ошибок, не останавливая другую работу.

Условия: проект добавлен в bb, провайдер установлен и авторизован.

Действия: создайте отдельный тред, опишите симптомы и укажите, где искать данные. Агент сможет изучить файлы, предложить исправление и запустить доступные тесты.

Наблюдаемый результат: в треде видны выполненные действия, ответы агента и изменения рабочего дерева.

Ограничение: пример с ошибкой cart на сайте bb демонстрирует продукт и не обещает автоматического исправления любого инцидента. Проверяйте diff и результаты тестов перед коммитом.

Добавить инструмент под процесс команды

Задача: встроить в IDE недостающую панель или команду, например локальный трекер задач.

Условия: открыт проект, агенту разрешено создавать файлы плагина.

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

Наблюдаемый результат: новый плагин появляется в интерфейсе и становится доступен агентам.

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

Запускать задачи из скриптов и ботов

Задача: создавать треды из cron, внутреннего сервиса или бота.

Условия: сервер bb уже запущен, а вызывающий процесс имеет безопасный доступ к нему.

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',
});

По умолчанию SDK и CLI обращаются к локальному серверу http://127.0.0.1:38886. Для другого адреса передайте baseUrl или настройте BB_SERVER_URL.

Наблюдаемый результат: созданный тред появляется в интерфейсе bb.

Ограничение: не публикуйте локальный HTTP-порт в недоверенной сети. Для удалённого доступа используйте предусмотренный защищённый маршрут.

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

1. Запустите:

npx bb-app@latest

Признак успеха: сервер и фоновый процесс запускаются без ошибок.

1. Откройте http://localhost:38886. Должен загрузиться веб-интерфейс.
2. Добавьте проект, создайте тред и выберите доступного провайдера.
3. Дайте безопасную задачу только на чтение, например попросите объяснить структуру репозитория. Успешный тред перейдёт в рабочее состояние и покажет действия агента.
4. Проверьте CLI:

npx --package bb-app bb --help

Команда должна вывести список доступных команд.

Если провайдер не появляется, проверьте, что его CLI установлен на том же хосте и доступен через PATH. В WSL2 установка в Windows и установка внутри Linux-дистрибутива считаются разными окружениями.

Ограничения и безопасный удалённый доступ

• Проект активно меняется. Команды и экспериментальные API следует сверять с текущей документацией и changelog.
• Linux AppImage имеет статус Alpha. Windows поддерживается через Ubuntu в WSL2; нативные Windows PowerShell и CMD в продуктовый путь не входят.
• Сервер по умолчанию слушает только 127.0.0.1:38886. Параметр --server-bind-host 0.0.0.0 открывает прямой доступ из сети и относится к чувствительным с точки зрения безопасности настройкам.
• Если включаете прямой доступ по LAN или tailnet, используйте только доверенную сеть. Не открывайте порт 38886 в интернете или общей локальной сети.
• Для работы с других устройств используйте bb connect либо публикуйте loopback-сервис через Tailscale Serve. После изменения адреса привязки требуется полный перезапуск приложения.
• Агенты выполняют команды и читают файлы с правами запущенного провайдера. Выдавайте минимально необходимые разрешения и проверяйте изменения перед коммитом.
• bb не предоставляет модели: без установленного и авторизованного провайдера треды не смогут выполнять задачи.
• Телеметрия управляется параметром BB_TELEMETRY; изменение применяется после полного перезапуска.

Тарифы и ссылки

Сам bb бесплатен и распространяется по лицензии MIT; репозиторий можно форкнуть и адаптировать под собственную сборку. Расходы зависят от подписок и API провайдеров, которых вы подключаете. Условия провайдеров и экспериментальных функций могут меняться; дата проверки — 8 сентября 2026 года.

Официальные источники:

• Сайт: https://getbb.app/
• Репозиторий: https://github.com/get-bb/bb
• README пакета bb-app
• Поддержка платформ
• Конфигурация
• Changelog

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

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

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

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

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

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