gastownhall/beads

Beads - A memory upgrade for your coding agent

解決的問題

Beads 為 AI Agent 提供持久化、結構化的記憶與問題追蹤系統。它用具有依賴感知能力的圖結構取代了非結構化的 Markdown 計劃，防止 Agent 在長期任務中遺失上下文，並消除了雜亂無章的 TODO 列表的需求。

工作原理

Beads 使用版本控制的 SQL 資料庫（由 Dolt 提供）來儲存任務與記憶。它作為一個 CLI 工具運行，Agent 可以使用它來建立、認領與關閉任務，同時追蹤依賴關係（例如：blocks, relates-to）。透過提供結構化的 JSON 輸出以及一個可以將必要的流程上下文與持久化記憶注入 Agent 提示詞的 bd prime 命令，它可以與各種 AI Agent（如 Claude Code, Codex, Factory.ai）整合。

適用對象

希望超越簡單的文本檔案進行任務管理，並為他們的 Agent 提供可靠的、版本控制的專案進度知識圖譜的開發者與 AI Agent 編排者。

亮點

  • Dolt 驅動的儲存： 使用具有單元級合併與原生分支功能的版本控制 SQL 資料庫，實現無衝突的多 Agent 工作流。
  • Agent 優化： 具有 JSON 輸出功能與「就緒」任務（即沒有未解決阻礙任務的任務）的自動偵測功能。
  • 語義記憶衰減： 包含壓縮功能，透過總結舊的已完成任務來節省上下文窗口空間。
  • 靈活的部署： 支援嵌入式與基於伺服器的儲存模式，並且可以完全在沒有 Git 的情況下運行。
  • 層級化任務： 透過層級 ID（例如 bd-a3f8.1.1）支援 Epic 與子任務。