Beads
lastmod 2026-11-16created 2025-10-172 edits
Beads(명령 이름 bd)는 AI 코딩 에이전트가 쓰는 분산 그래프 이슈 트래커이다. 에이전트가 마크다운 파일에 적던 작업 계획을 의존 관계가 있는 이슈 그래프로 바꿔, 긴 작업 중에도 무엇이 남았고 무엇에 막혔는지를 잃지 않게 한다. 데이터는 Dolt 데이터베이스에 두고 git 원격으로 여러 머신·에이전트가 함께 쓴다.
About
- Steve Yegge 의 steveyegge/beads 로 시작했고 지금 저장소는 gastownhall/beads
- 에이전트는
bd ready로 막힌 것이 없는 작업을 찾고,bd update<id>--claim으로 원자적으로 맡은 뒤bd close로 끝냄. 닫힌 작업이 막고 있던 작업은 다시 ready 목록에 올라옴 - 의존 링크는 blocks, related, parent-child. 지식 그래프용으로 relates-to, duplicates, supersedes, replies-to 링크도 있음
-
bd-a1b2같은 해시 기반 ID 라 여러 에이전트·브랜치에서 동시에 만든 이슈가 충돌하지 않음.bd-a3f8.1.1처럼 에픽-작업-하위 작업 계층 ID 도 씀 - 오래된 닫힌 작업은 요약해 줄이는 compaction 으로 컨텍스트 창을 아낌.
bd remember로 남긴 프로젝트 사실은bd prime이 나중에 에이전트에 다시 넣어 줌 - 기본은 Dolt 가 프로세스 안에서 도는 embedded 모드(쓰기 1개). 동시 쓰기가 필요하면 외부
dolt sql-server에 붙는 server 모드. 머신 간 동기화는 git 원격의refs/dolt/data로 push/pull 하고,.beads/issues.jsonl은 보기·교환용 내보내기 파일 -
bd init --stealth면 메인 저장소에 파일을 커밋하지 않고 혼자 씀 -
bd setup으로 Claude Code, Codex, Cursor, Factory Droid 등에 훅과 AGENTS.md 지침을 설치. MCP 서버 패키지(beads-mcp)도 있음 - macOS, Linux, Windows, FreeBSD 지원. MIT 라이선스