bb — 스스로를 제어하는 에이전틱 IDE

개요

get-bb/bb는 여러 코딩 에이전트를 하나의 작업공간에서 조율하는 오픈소스 에이전틱 IDE다. 프로젝트·환경·호스트·스레드를 중심으로 작업을 모델링하고, 데스크톱 앱·웹 앱·bb CLI·HTTP API·Node SDK를 모두 일급 인터페이스로 제공한다. README가 말하는 핵심 포지션은 “스스로를 제어하고, 스스로의 기능도 바꿀 수 있는 IDE”이며, 저장소는 현재 활발한 개발 단계다.

핵심 기능

멀티 에이전트 오케스트레이션: Claude Code, Codex, Cursor/ACP, Pi, OpenCode, Grok, Hermes Agent 등 이미 인증한 provider CLI를 같은 bb 환경에서 선택해 실행한다.
스레드 기반 실행: 표준 스레드는 직접 작업하고, manager 스레드는 다른 스레드를 조율한다. 자식 스레드 위임, 실시간 진행 추적, 중간 개입, 다른 에이전트로의 handoff를 지원한다.
다중 표면: 데스크톱 Electron 앱, 웹 UI, 스크립트 가능한 CLI, HTTP API, Node SDK가 동일한 작업 모델을 공유한다.
로컬·원격 호스트: host daemon이 각 실행 머신에서 workspace를 준비하고 provider 프로세스를 실행한다. 여러 호스트의 프로젝트 경로와 환경을 하나의 서버 모델에서 관리할 수 있다.
확장 가능한 제품 표면: 저장소에 plugins/automations, plugins/connect, plugins/custom-instructions 등의 플러그인 코드가 포함되어 있으며, 공식 사이트는 GitHub 연동·에이전트 메모리·예약 작업·원격 접근도 플러그인으로 설명한다.

아키텍처

server가 SQLite를 진실의 원천으로 삼아 HTTP API와 WebSocket 알림을 제공하고, host-daemon이 실제 머신에서 workspace·provider 프로세스를 담당한다. app은 프로젝트와 스레드를 관찰·조종하는 UI이고, cli는 사용자와 에이전트 모두가 호출할 수 있는 프로그래밍 가능한 인터페이스다.

서버-클라이언트 경계는 @bb/server-contract, 서버-host daemon 경계는 @bb/host-daemon-contract가 정의한다. 저장소는 apps/desktop, apps/app, apps/server, apps/host-daemon, apps/cli와 packages/sdk, packages/agent-runtime, packages/db 등으로 나뉜 TypeScript 모노레포다. 스레드의 메시지·툴 호출·파일 변경은 append-only event stream으로 축적된다.

설치와 실행

macOS Apple Silicon에서는 최신 데스크톱 앱을 사용할 수 있다. 현재 데스크톱 빌드는 arm64 전용이며 Intel Mac과 Linux는 npx 경로를 사용한다.
Linux에서는 Node.js 22.19 이상과 Git, 지원 provider 하나 이상을 준비한 뒤 다음처럼 실행한다.

npx bb-app@latest
# http://localhost:38886

최신 자동 빌드 채널은 npx bb-app@nightly다.
Windows는 네이티브 PowerShell/CMD가 아니라 WSL2 내부에서 실행해야 한다.
bb-app는 실행 중인 서버를 대상으로 하는 bb CLI와 Node SDK도 노출한다. SDK에서는 BBSdk로 스레드를 생성하고 대기·출력 조회를 자동화할 수 있다.
native addon 설치 스크립트가 차단된 npm 환경에서는 better-sqlite3 바인딩 오류가 날 수 있다. README는 일회성 우회로 npm_config_ignore_scripts=false npx bb-app@latest를 제시한다.

프라이버시·보안 고려사항

프로덕션 데스크톱 앱과 npx bb-app는 앱 시작, 스레드 생성 수, 사용자 메시지 수를 익명 telemetry로 보낸다. README에 따르면 무작위 설치 ID만 사용하고 사용자·호스트·프로젝트·workspace·메시지 내용은 첨부하지 않으며, BB_TELEMETRY=false로 끌 수 있다. 소스 개발 실행은 telemetry를 보내지 않는다고 명시되어 있다.

원격 접근은 Tailscale Serve를 우선 검토하고, 0.0.0.0 바인딩 호환 옵션은 보안 민감 옵션으로 취급해야 한다. Pi workspace는 저장된 trust policy가 승인한 뒤에만 프로젝트 리소스를 로드하며, unresolved ask 상태는 신뢰되지 않은 상태로 남는다. 따라서 “로컬 우선”은 데이터 경계 측면의 장점이지만, provider CLI와 원격 host를 연결할 때는 권한·네트워크·telemetry 설정을 별도로 점검해야 한다.

균형 잡힌 평가

핵심 워크플로와 표면이 아직 변하는 active-development 단계라서, 장기 호환성과 운영 안정성은 성숙한 IDE보다 낮을 수 있다.
데스크톱 앱은 현재 Apple Silicon macOS에 한정되고 Windows는 WSL2를 요구한다. 이는 플랫폼별 진입 장벽이다.
여러 provider CLI를 한곳에 모으는 장점은 provider별 인증·권한·비용·실패 모드를 한 계층에서 함께 관리해야 한다는 부담으로 바뀐다.
local-first라도 provider 프로세스와 선택한 원격 host를 통해 코드·명령 실행 경계가 넓어진다. telemetry, Tailscale/네트워크 바인딩, Pi trust policy를 기본값 그대로 신뢰해서는 안 된다.
targeted web search에서는 bb만을 다룬 Hacker News Show HN 스레드를 확인하지 못했다. 검색 결과에서 제품에 대한 공개 반응으로는 “바꿀 수 없는 도구로 돌아가지 않겠다”는 X 게시물과 공식 사이트의 높은 커스터마이즈 메시지가 보였지만, 이는 독립적인 성능 검증이나 사용자 만족도 조사로 해석하면 안 된다.

검증된 메타데이터

저장소: get-bb/bb
공식 사이트: getbb.app
기본 브랜치: main
raw 최종 저장 본문 SHA-256: 1d5fd3eea96c121d9da74c52b036b22d65de945747f2633963738a2e4b662dc3
다운로드한 README 원문 SHA-256(배지 자산 로컬화 전): 568cfb95aa47c2b1062569574b86012709da2d2a0346cdab14932bacfb5b7c9f
검증: wiki 후처리 훅이 npm·Discord 배지 이미지 2개를 raw/articles/assets/ 로컬 링크로 정규화했으며, 최종 저장 본문 기준으로 해시를 재계산함.
원문 캡처: raw source: github-get-bb-bb

description	Claude Code·Codex·Pi·ACP 에이전트를 스레드로 조율하고 앱·CLI·API·플러그인으로 확장하는 로컬 우선 IDE다.
tags	ai-agents, ai-coding, dev-tools, typescript, open-source

LLM Wiki

탐색기