gastownhall/beads
Beads - A memory upgrade for your coding agent
해결하는 문제
Beads는 AI 에이전트를 위해 특별히 설계된 영구적이고 구조화된 메모리 및 이슈 트래킹 시스템을 제공합니다. 비구조화된 마크다운 기반 계획을 의존성을 인식하는 그래프로 대체하여, 에이전트가 장기적인 작업 중에 컨텍스트를 잃는 것을 방지하고 번거로운 TODO 리스트의 필요성을 제거합니다.
작동 방식
Beads는 버전 관리되는 SQL 데이터베이스(Dolt 기반)를 사용하여 작업과 메모리를 저장합니다. 에이전트가 의존성(예: blocks, relates-to)을 추적하면서 작업을 생성, 할당 및 완료하는 데 사용할 수 있는 CLI 도구로 작동합니다. 구조화된 JSON 출력과 필요한 워크플로우 컨텍스트 및 영구 메모리를 에이전트의 프롬프트에 주입하는 bd prime 명령어를 통해 다양한 AI 에이전트(Claude Code, Codex, Factory.ai 등)와 통합됩니다.
대상 사용자
작업 관리를 위해 단순한 텍스트 파일을 사용하는 것에서 벗어나, 에이전트에게 프로젝트 진행 상황에 대한 신뢰할 수 있는 버전 관리된 지식 그래프를 제공하고자 하는 개발자 및 AI 에이전트 오케스트레이터.
주요 특징
- Dolt 기반 스토리지: 셀 수준의 병합 및 네이티브 브랜칭 기능을 갖춘 버전 관리 SQL 데이터베이스를 사용하여 충돌 없는 멀티 에이전트 워크플로우를 구현합니다.
- 에이전트 최적화: JSON 출력 및 "준비 완료" 작업(미해결 차단 요소가 없는 작업)의 자동 감지 기능을 제공합니다.
- 시맨틱 메모리 감쇠: 컨텍스트 윈도우 공간을 절약하기 위해 오래된 완료된 작업을 요약하는 압축 기능을 포함합니다.
- 유연한 배포: 임베디드 및 서버 기반 스토리지 모드를 모두 지원하며 Git 없이도 완전히 작동할 수 있습니다.
- 계층적 작업 관리: 계층적 ID(예:
bd-a3f8.1.1)를 통해 에픽과 하위 작업을 지원합니다.