Beads의 개요
Beads는 코딩 에이전트가 쓰는 markdown 할 일 목록을 에이전트가 조회할 수 있는 작은 이슈 트래커로 바꿉니다. 각 작업에는 bd-a1b2 같은 해시 기반 ID가 붙고, 작업끼리 차단, 상위, 중복 관계로 연결되며, `bd ready`는 앞에 열린 작업이 없는 일만 보여 줍니다. 에이전트는 `bd update --claim`으로 작업을 맡고(담당자와 상태를 한 번에 설정), `bd close`로 닫으면 그 작업이 막고 있던 일이 풀립니다. `bd remember`는 프로젝트 사실을 저장하고 `bd prime`이 다음 세션 시작 때 이를 다시 넣어 줍니다.
저장소는 버전 관리되는 SQL 데이터베이스인 Dolt입니다. 기본으로는 CLI에 내장되어 쓰기 주체가 하나뿐이고, 서버 모드는 dolt sql-server에 연결해 여러 주체가 동시에 쓸 수 있습니다. 머신 사이에서는 기존 git 원격 저장소의 ref를 대상으로 `bd dolt push`와 `bd dolt pull`로 동기화합니다. `bd init`은 AGENTS.md에 안내를 쓰고 Claude Code, Codex, Cursor용 훅도 설치합니다. 프로젝트는 steveyegge/beads에서 gastownhall 조직으로 옮겨졌고 예전 경로는 리디렉션됩니다.
Beads, 쓸 만한 가치가 있습니까?
Beads는 좁은 문제를 잘 풉니다. 월요일에 세운 계획을 화요일에 잊어버리는 에이전트입니다. 낡아 가는 PLAN.md 대신 에이전트는 `bd ready --json`으로 막히지 않은 일을 묻고, 발견한 것을 새 작업으로 기록합니다. 저장소는 GitHub 스타 약 28,700개이며, 2026년 4월 3일 v1.0.0에 도달했고 11월 4일 v1.3.4를 냈으며, 11월 13일에는 v1.4.0 릴리스 후보가 나왔습니다.
깔끔하게 병합되는 이유는 Dolt 백엔드입니다. 해시 ID 덕분에 두 브랜치의 두 에이전트가 같은 작업 번호를 만들 수 없고, Dolt는 행을 텍스트 줄이 아니라 셀 단위로 병합합니다. 기본 내장 모드는 데이터베이스를 .beads/에 두고 한 번에 하나의 쓰기 주체만 허용하므로, 여러 에이전트가 동시에 쓰려면 서버 모드가 필요합니다. .beads/issues.jsonl 파일은 뷰어용 내보내기일 뿐 백업이 아니어서, git에 평범한 파일이 있을 거라 기대한 사람은 놀랍니다.
기본 상태에서는 조용합니다. OpenTelemetry 내보내기는 BD_OTEL_ENABLED를 설정하지 않으면 꺼져 있고, 모델 호출은 선택 명령에서만 일어납니다. 오래전에 닫힌 작업을 요약해 컨텍스트를 아끼는 압축과 AI 중복 탐지는 모두 기본으로 사용자의 Anthropic 키로 Claude Haiku 4.5를 씁니다(지원하는 다른 제공업체는 MiniMax입니다). 악의적인 저장소에 대한 방어도 있습니다. 커밋된 .beads/.env로는 명령이나 자격 증명 헬퍼를 지정할 수 없고, 실험적 HTTP 클라이언트는 로컬이 아닌 서버에 암호화되지 않은 http로 토큰을 보내기를 거부합니다.
주의할 점: 변화가 빠릅니다. 트래커에는 열린 이슈 약 1,070건과 열린 풀 리퀘스트 697건이 있고, 업그레이드에는 스키마 마이그레이션이 포함될 수 있습니다. 공유 데이터베이스에서는 지정된 클론 하나가 먼저 마이그레이션을 실행한 뒤 나머지가 bootstrap해야 합니다. Ian Bull은 1월에 쓴 긴 글에서, 확인하라고 시키지 않으면 Claude가 Beads를 무시하고 CLAUDE.md의 지시는 긴 세션 동안 흐려진다고 했습니다. 그러니 훅이나 명시적 프롬프트가 여전히 필요합니다.
결론: 에이전트 하나가 짧은 작업을 할 때는 markdown 체크리스트로 충분합니다. 에이전트 둘, 머신 둘, 혹은 일주일짜리 리팩터링이 걸리면 Beads는 계획을 에이전트가 조회하고 git이 옮길 수 있는 형태로 유지합니다.
제 역할을 하는 곳
Claude Code로 일주일짜리 마이그레이션을 하는 1인 개발자
어제 세션이 멈춘 곳에서 그대로 이어 가기
`bd init`을 실행해 Claude Code 훅을 설치하게 합니다. 에이전트는 발견한 문제마다 작업으로 등록하고, 다음 날 아침 `bd prime`이 열린 작업을 되살립니다. 압축은 선택이므로 에이전트 외의 비용은 없습니다.
서로 다른 브랜치와 노트북에서 에이전트를 돌리는 4인 팀
계획 파일의 병합 충돌 없이 하나의 작업 그래프를 공유하기
`bd init --server`로 동시 쓰기용 dolt sql-server를 띄우고, 팀의 git 원격 저장소를 대상으로 `bd dolt push`와 `bd dolt pull`로 동기화합니다. 업그레이드마다 한 사람이 먼저 스키마 마이그레이션을 실행해야 하므로 팀 운영 문서에 적어 둘 만합니다.
오픈소스 프로젝트 기여자
남의 저장소에 파일을 더하지 않고 개인 계획을 관리하기
`bd init --stealth`는 Beads를 로컬에만 두고, `bd init --contributor`는 계획용 작업을 별도 저장소로 보내므로 풀 리퀘스트에는 코드만 담깁니다.
도입 전 확인할 점
- 설정
- `brew install beads` 또는 `npm install -g @beads/bd` 후 프로젝트에서 `bd init`을 실행합니다. --skip-agents나 --stealth를 주지 않으면 AGENTS.md 안내와 에이전트 훅을 씁니다.
- 연동
- `bd setup`으로 Claude Code, Codex, Cursor, Factory Droid 지원, PyPI의 beads-mcp 서버, 어떤 에이전트든 쓸 수 있는 JSON 출력, `bd serve`와 `bd connect`를 통한 실험적 HTTP 백엔드.
- 데이터와 개인정보
- 작업은 .beads/ 아래 Dolt 데이터베이스에 있고 git 원격 저장소의 ref와 동기화됩니다. 텔레메트리는 OpenTelemetry를 통한 옵트인입니다. 압축과 AI 중복 탐지는 키를 넣고 실행할 때만 작업 텍스트를 Anthropic이나 MiniMax로 보냅니다.
- 대규모 사용 시 비용
- 소프트웨어는 무료입니다. 압축에는 Claude Haiku 4.5 토큰 비용이 들고, 동시 쓰기용 Dolt 서버는 자체 인프라에서 돌아갑니다.
- 제한
- 내장 모드는 쓰기 주체가 하나입니다. 스키마 마이그레이션에는 조율된 업그레이드가 필요하고, HTTP 백엔드는 실험적이며 일부 작업을 거부합니다. 열린 이슈는 약 1,070건입니다.
좋은 점
- `bd ready`가 막히지 않은 작업만 JSON으로 에이전트에 전달
- 해시 ID와 Dolt의 셀 단위 병합으로 브랜치 간 작업 충돌 방지
- 이미 쓰는 git 원격 저장소로 동기화
- 텔레메트리는 기본으로 꺼짐, 모델 호출은 선택 명령에서만
아쉬운 점
- 내장 모드는 쓰기 주체가 하나뿐이라 병렬 에이전트에는 Dolt 서버가 필요
- 공유 데이터베이스에서는 스키마 마이그레이션 때문에 조율된 업그레이드가 필요
- 열린 이슈 약 1,070건, 열린 풀 리퀘스트 697건
- 꾸준히 쓰게 하려면 여전히 훅이나 프롬프트가 필요
추천 대상
Claude Code, Codex 또는 여러 에이전트로 며칠짜리 작업을 하면서 계획을 markdown이 아닌 조회 가능한 작업으로 저장하고 싶은 개발자.
Beads 대안
Beads: 자주 묻는 질문
- Beads, 쓸 만한 가치가 있습니까?
- Beads는 세션이 끝나도, 브랜치가 병합되어도 살아남는 작업 목록을 코딩 에이전트에 주지만, 그 대가로 데이터베이스와 잦은 스키마 마이그레이션, 붐비는 자체 이슈 트래커를 감수해야 합니다. 평점은 5점 만점에 4.0점입니다.
- Beads의 가격은 얼마입니까?
- 무료 오픈소스(MIT). 선택 기능인 압축과 AI 중복 탐지는 사용자의 Anthropic 또는 MiniMax 키로 모델을 호출합니다.
- Beads의 단점은 무엇입니까?
- 내장 모드는 쓰기 주체가 하나뿐이라 병렬 에이전트에는 Dolt 서버가 필요; 공유 데이터베이스에서는 스키마 마이그레이션 때문에 조율된 업그레이드가 필요; 열린 이슈 약 1,070건, 열린 풀 리퀘스트 697건; 꾸준히 쓰게 하려면 여전히 훅이나 프롬프트가 필요.
- Beads에 적합한 사람은 누구입니까?
- Claude Code, Codex 또는 여러 에이전트로 며칠짜리 작업을 하면서 계획을 markdown이 아닌 조회 가능한 작업으로 저장하고 싶은 개발자.
- 팀이나 프로덕션 환경에서 Beads의 비용은 얼마입니까?
- 소프트웨어는 무료입니다. 압축에는 Claude Haiku 4.5 토큰 비용이 들고, 동시 쓰기용 Dolt 서버는 자체 인프라에서 돌아갑니다.
- Beads에 회사 데이터를 맡겨도 안전합니까?
- 작업은 .beads/ 아래 Dolt 데이터베이스에 있고 git 원격 저장소의 ref와 동기화됩니다. 텔레메트리는 OpenTelemetry를 통한 옵트인입니다. 압축과 AI 중복 탐지는 키를 넣고 실행할 때만 작업 텍스트를 Anthropic이나 MiniMax로 보냅니다.
- Beads의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 claude-mem, Vibe Kanban 및 Spec Kit입니다.
답변 확인일: 2026년 11월 13일.
Beads 개발사입니까? 이 평점을 사이트에 표시하십시오
