'gastownhall/beads' 깃허브 트렌딩… AI 에이전트용 분산 그래프 이슈 트래커, Dolt 기반 버전드 SQL·해시 ID로 멀티 에이전트 머지 충돌 제거

AI 에이전트용 분산 그래프 이슈 트래커 'Beads'(gastownhall/beads)가 깃허브 트렌딩에 올랐다. 누적 2만 1,439스타에 일일 133스타가 추가됐다. macOS·Linux·Windows·FreeBSD에서 동작하며, 코딩 에이전트가 어수선한 마크다운 계획서 대신 의존성을 인지하는 그래프 형태의 영속 메모리를 사용해 장기 과업을 컨텍스트 손실 없이 진행할 수 있도록 하는 것이 핵심 가치다.

설치는 'bd' CLI를 시스템 단위로 한 번만 설치한 뒤 각 프로젝트에서 'bd init'으로 초기화하는 구조다. brew install beads 또는 npm install -g @beads/bd로 설치할 수 있고, AGENTS.md에 "Use 'bd' for task tracking"을 추가해 에이전트가 사용하도록 유도한다. 설치 스크립트는 릴리스 체크섬을 검증하며, macOS에서는 다운로드된 시그니처를 보존하고 BEADS_INSTALL_RESIGN_MACOS=1 환경변수로 재서명을 명시적으로 옵트인할 수 있다.

데이터 백엔드는 Dolt이다. 셀 단위 머지가 가능한 버전 컨트롤 SQL 데이터베이스로, 네이티브 브랜칭과 Dolt 리모트를 통한 동기화를 지원한다. 에이전트 친화적으로 JSON 출력, 의존성 추적, 자동 ready 태스크 감지를 제공하며, 'bd-a1b2' 형태의 해시 기반 ID는 멀티 에이전트·멀티 브랜치 워크플로우에서 머지 충돌을 원천 차단한다. '시맨틱 메모리 디케이' 컴팩션은 종료된 오래된 태스크를 요약해 컨텍스트 윈도우를 절약한다.

그래프 모델은 relates_to, duplicates, supersedes, replies_to 같은 링크 타입을 제공해 지식 그래프 형태의 연결을 만들고, '메시지' 이슈 타입은 --thread 옵션을 통한 스레딩, 일회성 라이프사이클, 메일 위임을 지원한다. 핵심 명령은 'bd ready'(차단 없는 태스크 목록), 'bd create "Title" -p 0'(P0 태스크 생성), 'bd update <id> --claim'(원자적 클레임으로 담당자 지정과 진행 중 상태 동시 변경), 'bd dep add <child> <parent>'(블록·관계·부모-자식 링크), 'bd show <id>'(감사 로그 포함 상세 보기) 등이다.

에픽 관리는 계층형 ID로 한다. 'bd-a3f8'(에픽) → 'bd-a3f8.1'(태스크) → 'bd-a3f8.1.1'(서브태스크) 식으로 무한 중첩이 가능하다. 또한 'bd init --stealth'를 실행하면 공유 프로젝트에서 메인 리포지터리에 파일을 커밋하지 않고 로컬에서만 Beads를 사용할 수 있고, 오픈소스 기여자는 'bd init --contributor'로 ~/.beads-planning 같은 별도 리포에 계획 이슈를 보내 PR에 실험 흔적이 남지 않도록 분리할 수 있다.

Dolt 운영 모드는 두 가지다. 기본 'bd init'은 임베디드 모드로 외부 서버 없이 .beads/embeddeddolt/에 데이터를 두고 단일 라이터(파일 락)만 허용한다. 'bd init --server'는 외부 dolt sql-server에 연결해 다중 동시 라이터를 지원하며, 기본 호스트 127.0.0.1, 포트 3307을 사용한다. --server-socket 또는 BEADS_DOLT_SERVER_SOCKET 환경변수로 유닉스 도메인 소켓을 지정하면 동시 프로젝트 간 포트 충돌을 피할 수 있고 Claude Code 같은 샌드박스 환경에서 파일 단위 접근 제어가 더 단순해진다.

백업은 'bd backup init', 'bd backup sync'로 설정·푸시하고, 'bd backup restore --force'로 새 프로젝트에 복원한다. Beads는 git 없이도 동작한다. BEADS_DIR 환경변수로 .beads/ 위치를 지정한 뒤 'bd init --quiet --stealth'를 실행하면 git 호출 없이 모든 핵심 명령이 동작하며, Sapling·Jujutsu·Piper 같은 비-git VCS, 모노레포 부분 트래킹, CI/CD의 격리된 태스크 트래킹, /tmp의 일회성 데이터베이스 같은 시나리오에 활용할 수 있다.