시작하기

설치부터 첫 워크스페이스 생성까지 2분 이내. Beadbox는 bd CLI를 감싸고 있어 두 가지를 모두 설치합니다.

1beads CLI 설치

bd 명령어는 Beadbox의 엔진입니다. Git 기반 스토리지를 사용하여 이슈, 에픽, 의존성을 로컬에서 관리합니다.

brew install beads

Homebrew가 필요합니다. bd 바이너리가 PATH에 설치됩니다.

설치 확인:

bd --version

버전 번호가 출력되어야 합니다. 명령어를 찾을 수 없는 경우, 설치 디렉터리가 PATH에 포함되어 있는지 확인하세요.

Beadbox는 네이티브 데스크톱 앱입니다. 사용 중인 플랫폼의 설치 프로그램을 선택하세요.

brew tap beadbox/cask && brew install --cask beadbox

GitHub Releases에서 DMG를 직접 다운로드할 수도 있습니다.

Beadbox를 실행합니다. 다음에 표시되는 화면은 설정 상태에 따라 다릅니다.

Beadbox는 시작 시 bd CLI를 검색합니다. 찾을 수 없으면 설치 안내와 "다시 확인" 버튼이 있는 환영 화면이 표시됩니다.

bd가 감지되면 빠른 시작 카드가 표시됩니다. 프로젝트 폴더를 선택하고 워크스페이스 설정을 클릭하면 Beadbox가 bd을 실행합니다. 워크스페이스가 준비되며, 모든 데이터는 로컬에 저장됩니다.

Beadbox는 ~/.beads/registry.json과 .beads/ 폴더가 있는 프로젝트 디렉터리에서 워크스페이스를 감지합니다. 워크스페이스를 클릭하여 엽니다. 에픽 트리가 실시간 상태 인디케이터와 함께 로드됩니다.

터미널에서의 변경 사항이 실시간으로 반영됩니다. 터미널에서 bd update <id> --status closed를 실행하면 2초 이내에 Beadbox의 상태가 업데이트됩니다. 새로고침은 필요 없습니다.

메인 화면은 세 가지 영역으로 구성되어 있습니다:

워크스페이스 전환, 연결 상태 확인, 수동 새로고침을 할 수 있습니다. 키보드 단축키 설정도 여기에 있습니다.

상태, 우선순위, 담당자, 전체 텍스트 검색으로 필터링할 수 있습니다. 업데이트 날짜, 생성 날짜, 우선순위, 상태로 정렬 가능합니다. 필터는 워크스페이스별로 유지됩니다.

에픽과 하위 태스크의 계층 뷰입니다. 펼치면 상태 배지, 우선순위 인디케이터, 진행 카운트가 표시됩니다. bead를 클릭하면 상세 정보가 열립니다.

bead의 전체 메타데이터: 설명, 코멘트, 의존성, 수락 기준. 모두 마크다운으로 렌더링됩니다.