beads

Beads는 코딩 에이전트에게 마크다운 TODO 목록의 구조화된 대안을 제공합니다. 작업, 차단 항목, 메시지, 지속적인 프로젝트 사실은 Dolt 버전 관리 SQL 데이터베이스에 저장되며, 의존성 그래프는 어떤 작업이 클레임할 준비가 되었는지 결정합니다. `bd` 명령줄 인터페이스는 핵심 워크플로를 지원합니다: `bd init`로 프로젝트 초기화, 작업 생성, 의존성 추가, `bd ready`로 차단되지 않은 작업 나열, `bd update --claim`으로 원자적으로 작업 클레임, `bd show`로 세부 정보 및 감사 기록 확인, `bd close`로 항목 완료. `bd prime`은 에이전트에 워크플로 컨텍스트와 저장된 메모리를 제공하고, `bd remember`는 지속적인 프로젝트 사실을 저장합니다. Beads는 `bd-a1b2`와 같은 해시 기반 ID를 사용하며 계층적 에픽/작업/하위 작업 ID를 지원합니다. 에이전트용 JSON 출력, 자동 준비 작업 감지, 우선순위 값, `relates-to`, `duplicates`, `supersedes`, `replies-to`와 같은 그래프 관계, 그리고 일시적 수명 주기를 가진 스레드 메시지 이슈를 포함합니다. 컴팩션 기능은 오래된 닫힌 작업을 요약하여 에이전트가 로드해야 하는 컨텍스트를 줄입니다. Dolt는 브랜칭, 셀 수준 병합 동작, 리모트를 통한 동기화를 제공합니다. 기본 임베디드 모드는 단일 작성자로 프로세스 내에서 Dolt를 실행하며, 서버 모드는 동시 작성자를 위해 외부 `dolt sql-server`에 연결합니다. 머신 간 동기화는 `bd dolt push`와 `bd dolt pull`을 사용합니다. 저장소는 백업, 프루닝, 퍼지, 스키마 버전 검사, 마이그레이션 절차, 스키마 불일치에 대한 탈출구도 문서화합니다. 에이전트 설정은 Codex CLI, Claude Code, Factory.ai, Cursor 등 지원 도구에 대해 `bd setup`을 통해 가능합니다. 초기화는 `AGENTS.md` 지침과 훅을 추가할 수 있으며, `bd onboard`는 지원되지 않는 에이전트에 대한 스니펫을 출력합니다. Beads는 `BEADS_DIR`와 `--stealth`를 사용하여 Git 없이도 실행할 수 있어 비-Git 버전 관리 시스템, 모노레포, CI 환경, 임시 데이터베이스에서 사용할 수 있습니다. 프로젝트는 macOS, Linux, Windows, FreeBSD를 지원합니다. 설치 옵션에는 Homebrew, npm, 설치 스크립트, Go 설치, 소스 빌드, 플랫폼별 패키지가 포함됩니다. README는 다운로드한 바이너리를 신뢰하기 전에 릴리스 체크섬을 검증하라고 조언합니다.