beads

AI編碼代理記不住項目細節？beads提供持久化內存系統，讓代理跨會話保持上下文和狀態。通過x-cmd一鍵安裝，提升AI代理的記憶力。

Language	Go
Homepage	https://github.com/steveyegge/beads

容器調用: ^{實驗性功能}

1. 使用 docker 模組自動拉取基礎鏡像，並在首次執行時根據需求重構為一個可直接運行的完整軟件鏡像。
2. 在後續運行中，命令會基於已構建好的鏡像快速啓動容器，實現秒級響應。
3. 所有操作均在容器內部完成，與本地系統完全隔離，無需任何本地依賴，安全、乾淨且不留痕跡。
4. 當因軟件版本或依賴發生變化需重構鏡像時，會充分利用 Docker 鏡像構建的緩存機制，最大限度地複用已下載的依賴與構建成果，大幅縮短重建耗時。

該功能仍在測試中，使用過程中如有問題，歡迎在 X-CMD 社區 留言反饋。

x docker alpine bd

xd alp bd

---

x install beads

/curl	curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
/npm	npm install -g @beads/bd
/go	go install github.com/steveyegge/beads/cmd/bd@latest
darwin/brew	brew install beads

beads：Git 驅動的圖結構 Issue 追蹤器，解決 AI 代理的上下文失憶問題

AI 編碼代理（如 Claude Code、Codex）擅長解決具體任務，但在長週期項目中經常"失憶"——忘記之前的規劃、丟失任務依賴關係。beads 是一個基於 Git 的分佈式圖結構 Issue 追蹤系統，專門設計用來為 AI 代理提供持久化內存。

它把任務存儲為 .beads/ 目錄下的 JSONL 文件，利用 Git 進行版本控制、分支合併。與 Markdown 計劃文件不同，beads 使用依賴感知的圖結構，支持任務間的關聯（阻塞、重複、替代、回覆），讓代理能夠處理長週期任務而不丟失上下文。

核心特性

特性	説明
Git 作為資料庫	任務以 JSONL 格式存儲，天然支持版本控制、分支、合併
哈希 ID 防衝突	短哈希 ID（如 bd-a1b2）避免多代理/多分支場景的合併衝突
依賴追蹤	支持 relates_to、duplicates、supersedes 等關係類型
層級結構	支持 Epic → Task → Sub-task 的層級 ID（如 bd-a3f8.1.1）
消息線程	內置消息類型支持線程化討論，適用於代碼審查和協作
語義壓縮	自動總結已關閉的老任務，節省上下文窗口

典型工作流

# 初始化項目
cd your-project
bd init

# 查看可執行的任務（無阻塞依賴）
bd ready

# 創建 P0 級任務
bd create "重構支付模組" -p 0

# 聲明任務（原子性分配）
bd update bd-a1b2 --claim

# 添加任務依賴
bd dep add bd-a1b2 bd-a3f8

適用場景

• 多代理協作：不同代理處理相互依賴的任務時，通過 beads 協調避免衝突
• 長週期項目：需要跨會話保持項目規劃和任務狀態的記憶
• 分支開發：在功能分支上記錄計劃，合併時自動整合任務狀態
• 開源貢獻：--contributor 模式可將個人計劃與上游倉庫分離，保持 PR 乾淨

與代理集成

在項目的 AGENTS.md 中添加一行簡單的指令："Use 'bd' for task tracking"，AI 代理就能理解如何使用 beads 管理任務。beads 的 JSON 輸出格式和自動就緒任務檢測，讓代理可以程序化地查詢和更新任務狀態。

來源：

https://github.com/steveyegge/beads