수록 현황:261 건의 뉴스/91 개의 AI 도구/372 개의 오픈소스 프로젝트/64 개의 학습 자료
홈뉴스오픈소스모델AI 도구학습 자료
홈 / 오픈소스 / beads

beads

코딩 에이전트에게 영구적이고 구조화된 메모리를 제공하여 장기적인 작업 관리를 가능하게 하는 분산형 Git 기반 그래프 이슈 트래커.

GoMITAgent
⭐ GitHubhttps://github.com/steveyegge/beads
25,703
스타 수
+5,768
스타 증가율
Jul 28, 2026
최근 업데이트
3,124
클릭 수

Beads (bd) — 코딩 에이전트를 위한 메모리 업그레이드

개요

Beads는 AI 코딩 에이전트(Claude Code, GitHub Copilot 등)에 영구적이고 구조화된 메모리 시스템을 제공하기 위해 설계된 오픈 소스 CLI 도구(bd)입니다. 세션 간에 사라지는 플랫 마크다운 파일이나 인컨텍스트 스크래치패드에 의존하는 대신, Beads는 버전 관리되는 SQL 데이터베이스를 기반으로 하는 의존성 인식 작업 그래프를 제공합니다. 이를 통해 에이전트는 여러 세션, 브랜치, 심지어 여러 협업 에이전트에 걸쳐 장기 작업을 안정적으로 계획, 추적 및 실행할 수 있습니다.

이 프로젝트는 주로 Go(91.9%)로 작성되었으며, Python(5.5%)과 Shell(1.1%)이 스택을 구성합니다. macOS, Linux, Windows 및 FreeBSD를 지원합니다.

해결하는 핵심 문제

AI 코딩 에이전트는 두 가지 심각한 한계에 직면합니다.

  1. 짧은 컨텍스트 창 — 긴 작업은 잊혀지거나 잘립니다.
  2. 영구적인 작업 상태 없음 — 마크다운으로 작성된 계획은 불안정하고 구조화되지 않으며 쉽게 손실됩니다.

Beads는 구조화된 외부 메모리 역할을 하여 이 두 가지 문제를 해결합니다. 작업은 데이터베이스( Dolt 기반)에 저장되고, git으로 버전 관리되며, 간단한 CLI와 JSON 출력을 통해 에이전트에 노출됩니다.

주요 기능

🔷 Dolt 기반 스토리지

Beads는 셀 단위 병합, 네이티브 브랜칭 및 Dolt 원격을 통한 동기화를 지원하는 버전 관리 SQL 데이터베이스인 Dolt를 사용합니다. 이는 작업 데이터베이스 자체에 완전한 git과 유사한 기록이 있음을 의미합니다.

🤖 에이전트 최적화 인터페이스

모든 명령은 기본적으로 JSON 출력을 생성하여 에이전트가 프로그래밍 방식으로 결과를 쉽게 파싱할 수 있도록 합니다. bd ready 명령은 열려 있는 차단기가 없는 작업을 자동으로 감지하여 에이전트가 다음에 무엇을 해야 할지 안내합니다.

🔗 의존성 그래프

작업은 유형화된 관계로 연결될 수 있습니다.

  • blocks / blocked_by
  • relates_to
  • duplicates
  • supersedes
  • replies_to

이는 단순한 플랫 목록이 아닌 진정한 지식 그래프를 형성합니다.

🧠 의미론적 메모리 압축

오래된 완료된 작업은 필수 기록을 보존하면서 컨텍스트 창 사용량을 줄이기 위해 자동으로 요약됩니다("메모리 감쇠").

💬 메시징 시스템

내장된 message 이슈 유형은 스레드 토론(--thread), 임시 수명 주기 및 에이전트 간의 메일 위임을 지원합니다.

🪢 계층적 작업 ID

작업은 해시 기반 ID를 통해 에픽/작업/하위 작업 중첩을 지원합니다.

bd-a3f8       (Epic)
bd-a3f8.1     (Task)
bd-a3f8.1.1   (Sub-task)

해시 기반 ID는 다중 에이전트 워크플로에서 병합 충돌을 방지합니다.

🥷 스텔스 모드

bd init --stealth를 사용하면 주 저장소에 파일을 커밋하지 않고도 로컬에서 Beads를 사용할 수 있습니다. 공유 또는 오픈 소스 프로젝트에서 개인적으로 사용하기에 완벽합니다.

👥 기여자 vs 유지 관리자 역할

  • 기여자 (포크된 저장소): bd init --contributor는 계획 이슈를 별도의 개인 저장소로 라우팅하여 실험적인 작업을 PR에서 제외합니다.
  • 유지 관리자: Beads는 SSH URL 또는 인증된 HTTPS를 통해 유지 관리자 역할을 자동으로 감지합니다.

필수 CLI 명령

명령 설명
bd init 프로젝트에서 Beads 초기화
bd ready 열려 있는 차단기가 없는 작업 나열
bd create "Title" -p 0 P0(최고 우선순위) 작업 생성
bd update <id> --claim 작업을 원자적으로 클레임 (할당자 + 진행 중 설정)
bd dep add <child> <parent> 작업에 의존성 관계 연결
bd show <id> 작업 세부 정보 및 감사 추적 보기

설치

# 원라인 설치
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

# 또는 npm을 통해
npm install -g @beads/bd

# 또는 Homebrew를 통해
brew install beads

# 또는 Go를 통해
go install github.com/steveyegge/beads/cmd/bd@latest

그런 다음 프로젝트에서 초기화합니다.

cd your-project
bd init
echo "Use 'bd' for task tracking" >> AGENTS.md

통합

Beads는 주요 AI 코딩 에이전트 및 IDE와 통합됩니다.

  • Claude Code (Anthropic)
  • GitHub Copilot
  • Cursor, Windsurf, Amp 및 기타 MCP 호환 도구
  • MCP 서버는 PyPI의 beads-mcp를 통해 사용 가능

커뮤니티 구축 확장 기능에는 터미널 UI, 웹 대시보드, 편집기 플러그인 및 네이티브 앱이 포함됩니다. 전체 목록은 docs/COMMUNITY_TOOLS.md를 참조하십시오.

프로젝트 통계 (2026년 초 기준)

지표 값
GitHub Stars 17,300+
Forks 1,100+
Contributors 258
Releases 78
Primary Language Go
License MIT

누구를 위한 것인가?

  • 자율 코딩 파이프라인을 구축하는 AI 에이전트 개발자
  • 더 나은 작업 추적을 원하는 Claude Code, Copilot 또는 Cursor를 사용하는 개인 개발자
  • 공유 코드베이스에서 다중 에이전트 워크플로를 실행하는 팀
  • 업스트림 저장소를 오염시키지 않고 개인 작업 관리가 필요한 오픈 소스 기여자

요약

Beads는 AI 코딩 에이전트 생태계의 중요한 격차를 채웁니다. 영구적이고 구조화되며 버전 관리되는 메모리입니다. 그래프 기반 작업 모델과 git 네이티브 SQL 백엔드 및 에이전트 친화적인 CLI를 결합하여 코딩 에이전트가 컨텍스트 한계를 초과하는 복잡한 다중 세션 프로젝트를 처리할 수 있도록 합니다. MIT 라이선스, 다중 플랫폼 지원 및 활발한 커뮤니티는 AI 코딩 도구를 진지하게 다루는 모든 사람에게 실용적인 선택이 될 것입니다.