beads

Beads (br) 是一款專門為解決 AI 代理上下文易失性問題而設計的基於圖形的問題追蹤工具。與在對話壓縮期間會重置的標準線性待辦事項清單不同，Beads 為跨會話工作提供了持久的記憶。它專為任務具有複雜相依性、阻礙並需要高保真狀態恢復的長期軟體工程專案而建。透過利用 Git 備份儲存，它確保了專案的路線圖、筆記和任務進度在不同的編碼會話和團隊成員之間保持同步和可存取。

• 實現了在對話壓縮和上下文重置後仍能持續存在的持久記憶。

• 實作了基於圖形的任務相依性管理，以追蹤阻礙因素並對複雜的工作流程進行排序。

• 與 Git 整合，允許將問題狀態（基於 SQLite）匯出為 JSONL 並透過版本控制進行追蹤。

• 支援多使用者團隊同步，利用標準的 Git 工作流程。

• 透過提供更新狀態、捕捉工作筆記和上下文恢復的結構化協議，促進會話交接。

• 作為專為 AI 代理設計的命令列介面 (CLI) 運行，使其能夠自主管理自己的任務清單。

• 當工作跨越數天或多個會話，或者上下文對於在壓縮期間不丟失至關重要時，請使用 Beads。

• 使用 br CLI 命令，例如 br ready 來尋找未被阻礙的工作，br update 來轉換狀態，以及 br sync 將變更提交到您的儲存庫。

• 務必使用 br dep add 命令定義相依性以釐清操作順序，請注意其方向性表示第二個參數必須先於第一個參數完成。

• 確保儲存庫中存在 .beads/ 目錄；如果在新複製後遺失，請使用 br sync --import-only 重新填充資料庫。

• 當任務邊界模糊、包含研究組件，或需要對開發過程中做出的決策進行持久的歷史追蹤時，請優先選擇 Beads 而非像 TodoWrite 這樣的臨時工具。