get-bb/bb

bb – 스스로를 구축하는 "에이전트형" IDE

이것이 무엇인가 – bb는 데스크톱 GUI, 웹 UI, 명령줄 인터페이스, 또는 HTTP API에서 구동할 수 있는 풀스택 개발 환경입니다. 이는 자율적인 "에이전트"(스크립트, 봇, 또는 AI 기반 도우미)가 IDE 자체를 제어하고, 사용자화하고, 자동화할 수 있도록 설계되어, 환경을 일종의 개인 소프트웨어 공장으로 바꿔줍니다.

핵심 아이디어

자기 구축 – IDE는 실행 중에 자체 구성을 수정하고, 플러그인을 설치하며, 새 코드를 생성할 수도 있습니다.
다중 인터페이스 – 동일한 기본 시스템이 다음을 통해 노출됩니다:
- 네이티브 데스크톱 앱(Electron 기반, macOS Apple-Silicon 안정, Linux/Windows 알파),
- http://localhost:38886에서 접근 가능한 웹 앱,
- bb CLI, 그리고
- REST 스타일 HTTP API.
스레드 기반 작업 – 작업은 독립적인 스레드에서 실행되며, 실시간으로 지켜보거나, 개입하거나, 다른 에이전트에 넘길 수 있습니다.
확장 가능한 플러그인 모델 – 플러그인은 공개 bb-커뮤니티 마켓플레이스에 게시하거나, 로컬 경로, 개인 git 저장소, 또는 npm 패키지에서 로드할 수 있습니다.

시작하기

데스크톱 앱 – GitHub desktop-latest 태그에서 최신 릴리스를 다운로드하세요. macOS Apple-Silicon이 공식 지원되며, Linux 및 Windows 빌드는 실험적입니다.
어디서나 실행 – 단일 명령으로 서버를 로컬에서 실행할 수 있습니다:
```
npx bb-app@latest   # 그런 다음 http://localhost:38886을 여세요
```
(최신 사전 릴리스에는 @nightly 사용). npm 12+에서는 네이티브 애드온 설치 스크립트를 허용해야 합니다, 예:
```
npx --allow-scripts=better-sqlite3,node-pty,@parcel/watcher bb-app@latest
```
CLI 접근 – 설정 → 일반 → 명령줄 패널에서 bb 명령을 활성화한 다음, bb …를 사용하여 터미널이나 다른 자동화에서 시스템을 구동하세요.

개발 워크플로우

pnpm dev – Vite 기반 핫 리로딩 프론트엔드를 시작하고 API/WebSocket 트래픽을 별도의 개발 서버로 프록시합니다.
pnpm start – 프로덕션 스타일 번들을 빌드하고 실행합니다.
특수 스크립트(pnpm dev:remote, pnpm start:worktree-remote 등)는 신뢰할 수 있는 네트워크(예: Tailscale)를 통해 UI와 API를 노출하여 다중 장치 사용을 가능하게 합니다.
저장소는 모노레포입니다; 패키지 맵은 docs/repository-overview.md를 참조하세요.

원격 측정

프로덕션 실행(데스크톱 앱, npx bb-app, 또는 체크아웃된 빌드)은 익명 사용 이벤트(앱 시작, 스레드 생성 수, 메시지 수, 플러그인 설치)를 전송합니다. 이벤트에는 버전, 설치 방법, OS/CPU/Node 세부 정보, 그리고 설치별 무작위 식별자가 포함됩니다. 프로젝트 이름, 파일 경로, 커밋 해시, 또는 메시지 내용은 전송되지 않습니다.
개발 실행(pnpm dev, pnpm start:worktree 등)은 원격 측정을 전송하지 않습니다.
원격 측정은 BB_TELEMETRY=false로 비활성화할 수 있습니다.

현재 상태

핵심 아키텍처는 안정적이지만, UI 표면, 워크플로우, 플러그인 생태계는 여전히 진화 중입니다(README는 프로젝트가 활발히 개발 중임을 명시).
네이티브 애드온(better-sqlite3, node-pty, @parcel/watcher)이 필요합니다; 최근 npm 버전은 기본적으로 설치 스크립트를 차단하므로 README에 명시적인 해결 방법이 제공됩니다.

대상 사용자

스크립트나 AI 에이전트로 프로그래밍 방식으로 제어할 수 있는 IDE를 원하는 개발자.
도구 자체를 생성, 확장, 자동화할 수 있는 "소프트웨어 공장"을 구축하는 팀.
Node.js, npm, 선택적 데스크톱 앱 설치에 익숙한 사용자.

더 알아보기

시스템 및 데이터 모델 세부 정보: docs/system-overview.md
비전 및 로드맵: docs/VISION.md
구성 가이드: docs/configuration.md
커뮤니티 Discord(README 상단 배지의 링크).

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.

get-bb/bb

bb – 스스로를 구축하는 "에이전트형" IDE

관련