콘텐츠로 이동
Search

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 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap