gastownhall/beads

어떤 프로젝트인가요?

핵심 기능

• 01`bd ready`로 차단되지 않은 작업을 확인할 수 있도록 작업을 의존성 그래프로 저장합니다.
• 02멀티 에이전트 워크플로에서 `bd update --claim`으로 작업을 원자적으로 맡을 수 있습니다.
• 03해시 기반 ID와 Dolt 브랜치로 브랜치 간 병합 충돌을 줄입니다.
• 04에픽과 하위 작업을 위한 계층형 ID와 그래프 링크 유형을 지원합니다.
• 05시맨틱 압축으로 오래전에 완료된 작업을 요약해 컨텍스트 윈도우를 절약합니다.
• 06Git 없이 사용하는 모드와 Claude Code, Codex, Cursor용 에이전트 통합 기능을 제공합니다.

활용 사례

• 코딩 에이전트가 여러 단계로 이뤄진 장기 프로젝트에서 지속적으로 작업 메모리를 유지하도록 합니다.
• 서로 다른 브랜치에서 같은 저장소를 다루는 여러 에이전트의 작업을 조율합니다.
• 오픈 소스 프로젝트에 기여할 때 계획 관련 이슈를 별도로 추적합니다.
• CI 또는 Git을 사용하지 않는 버전 관리 환경에서 격리된 작업 추적을 실행합니다.

빠른 시작

1. 1

   bd CLI를 시스템 전체에 설치합니다

   README의 공식 안내에 따라 설치
2. 2

   프로젝트 디렉터리로 이동합니다

   cd your-project
3. 3

   프로젝트에서 beads를 초기화합니다

   bd init

사용 전 알아둘 점

• !Dolt 기반 데이터베이스가 필요하므로 팀에서 이해해야 할 종속성이 추가됩니다.
• !일부 HTTP 백엔드 동작은 로컬 모드와 다르며 실험적 기능으로 문서화되어 있습니다.
• !안전하게 수동 설치하려면 설치 스크립트와 바이너리 검증 절차가 필요합니다.

토픽

자주 묻는 질문

beads은(는) 무엇인가요?

코딩 에이전트에 지속적이고 의존성을 인식하는 작업 메모리를 제공하는 Dolt 기반 분산 그래프 이슈 트래커 Beads(`bd` CLI)는 AI 코딩 에이전트를 위해 만든 이슈 트래커입니다. 계획을 정리되지 않은 Markdown 파일에 두는 대신, 버전 관리되는 SQL 데이터베이스에 작업을 의존성 그래프로 저장합니다. 에이전트는 열려 있는 차단 작업이 없는 일감을 요청하고, 작업을 원자적으로 맡은 뒤 완료 처리할 수 있습니다. 그러면 해당 작업에 의존하는 작업이 진행 가능한 상태가 되어, 맥락을 잃지 않고 장기 작업을 추적할 수 있습니다.

beads은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

beads은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

beads은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. beads의 마지막 커밋은 2026년 10월 19일입니다.

beads은(는) 어디에 사용할 수 있나요?

코딩 에이전트가 여러 단계로 이뤄진 장기 프로젝트에서 지속적으로 작업 메모리를 유지하도록 합니다. 서로 다른 브랜치에서 같은 저장소를 다루는 여러 에이전트의 작업을 조율합니다. 오픈 소스 프로젝트에 기여할 때 계획 관련 이슈를 별도로 추적합니다. CI 또는 Git을 사용하지 않는 버전 관리 환경에서 격리된 작업 추적을 실행합니다.

beads는 어떻게 설치하나요?

bd CLI를 시스템 전체에 설치합니다 프로젝트 디렉터리로 이동합니다: cd your-project 프로젝트에서 beads를 초기화합니다: bd init

beads은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/gastownhall/beads