블로그로 돌아가기

Beadbox를 만든 이유

AI 코딩 에이전트를 10개 병렬로 실행할 수 있게 되었습니다. tmux 세션을 띄우고, 각 에이전트에 태스크를 할당하고, beads를 통해 조율합니다. 실제로 동작합니다. 저희는 매일 이렇게 일합니다.

하지만 아무도 말하지 않는 것이 있습니다. 무슨 일이 벌어지고 있는지 전혀 보이지 않는다는 것입니다.

가시성의 공백

beads는 메모리 문제를 해결했습니다. beads 이전에는 에이전트가 세션 간에 모든 것을 잊어버렸습니다. 마크다운 TODO 파일을 반복 처리하고, 컴팩션 후 컨텍스트를 잃고, 같은 버그를 세 번씩 재발견했습니다. beads는 에이전트에게 영속적이고 구조화된 Git 기반 메모리를 제공했습니다. 획기적인 변화였습니다.

하지만 beads는 CLI 도구입니다. 에이전트를 위해 만들어졌지, 에이전트를 감독하는 사람을 위한 것이 아닙니다. 프로젝트 상태를 파악하려면 bd list를 실행합니다. 이슈의 플랫한 목록이 나옵니다. bd show bb-abc로 하나를 읽습니다. 그다음 또 하나. 그리고 bd dep list를 실행해서 무엇이 무엇을 블로킹하는지 파악합니다. 한 조각씩, 머릿속에서 전체 그림을 재구성합니다.

이슈가 5개일 때는 괜찮습니다. 50개가 되면 무너집니다. 그리고 10개의 에이전트가 실시간으로 이슈를 생성, 업데이트, 종료하고 있을 때, CLI로는 당신의 속도에도, 에이전트의 속도에도 맞출 수 없습니다.

저희가 만든 것

Beadbox는 beads 위에 구축된 비주얼 레이어입니다. .beads/ 디렉토리의 변경사항을 감시하고 네이티브 데스크톱 앱에서 밀리초 단위로 모든 것을 렌더링합니다. 에이전트가 터미널에서 이슈를 업데이트하면, 셸 프롬프트가 돌아오기 전에 Beadbox에 표시됩니다.

계정 필요 없음. 클라우드 없음. 동기화 없음. 데이터는 여러분의 머신에, 에이전트가 이미 사용하고 있는 .beads/ 디렉토리에 그대로 남습니다. Beadbox는 그것을 읽어서 무슨 일이 일어나고 있는지 보여줄 뿐입니다.

실제로는 이렇게 보입니다:

프로그레스 바가 있는 에픽 트리. 최상위 에픽이 12개의 하위 태스크 중 7개 완료로 표시됩니다. 펼치면 어떤 서브태스크가 블로킹되어 있는지, 어떤 것이 QA 중인지, 어떤 에이전트가 무엇을 작업하고 있는지 볼 수 있습니다. 한 눈에 수십 개의 bd show 명령을 대체합니다.

실시간 동기화. 파일 시스템의 데이터베이스 변경을 감시합니다. 에이전트가 상태 변경을 커밋하면, Beadbox는 파일 감시 파이프라인을 통해 이를 감지하고 WebSocket으로 UI에 푸시합니다. 폴링 없음. 새로고침 버튼 없음.

멀티 워크스페이스 지원. 여러 프로젝트에 걸쳐 작업하는 경우, 드롭다운에서 beads 데이터베이스를 전환할 수 있습니다. 각 워크스페이스는 자체 필터와 뷰 상태를 기억합니다.

의존성 가시화. 블로킹 관계가 모든 이슈에 배지로 표시됩니다. 명령어 하나 실행하지 않고도 bb-q3l이 bb-f8o를 기다리고 있다는 것을 한눈에 알 수 있습니다.

Beadbox 개발 방법

저희는 beads와 Beadbox를 사용해서 Beadbox를 개발합니다. 단순한 기믹이 아닙니다. 일상적인 워크플로에서 10개 이상의 Claude Code 에이전트를 슈퍼바이저 에이전트를 통해 조율합니다. 엔지니어링, QA, 프로덕트, 마케팅, 릴리스, 모두 단일 데이터베이스의 beads로 추적됩니다. 에이전트가 이슈를 생성하고, 작업을 가져가고, 코드를 푸시하고, 결과를 보고하는 동안 Nelson은 Beadbox에서 전체 오퍼레이션을 지켜봅니다.

출시하는 모든 기능은 먼저 자체 워크플로에서 테스트됩니다. 6개 에이전트에 걸쳐 50개의 활성 이슈가 있을 때 에픽 트리가 이해하기 어렵다면, 다른 누군가가 그 문제에 부딪히기 전에 고칩니다.

기술 스택은 의도적으로 단순합니다: UI에 Next.js, 네이티브 래퍼에 Tauri, 유일한 소스 오브 트루스로 bd CLI. 데이터베이스를 직접 읽지 않습니다. 모든 작업은 bd를 통하므로, Beadbox는 항상 터미널과 일치합니다.

향후 방향

현재 Beadbox는 대시보드입니다. 에이전트의 작업을 지켜보고, 이슈를 트리아지하고, 에픽 전체의 진행 상황을 추적합니다.

앞으로는 컨트롤 플레인이 될 것입니다. 에이전트에 작업을 디스패치하고, 아웃풋을 리뷰하고, 하나의 윈도우에서 전체 플릿을 관리할 수 있는 세상을 만들어 가고 있습니다. 터미널은 에이전트의 홈으로 남습니다. Beadbox가 여러분의 홈이 됩니다.

베타 기간 동안 무료입니다. 사용해 보세요.