beads - A memory upgrade for your coding agent

📄 Summarized by Claude Sonnet 4.6

2026年4月（最新リリース v1.0.3）

どんなもの？

Beads（bd）は、AIコーディングエージェント向けの永続的・構造的メモリを提供する分散グラフ型イシュートラッカー。マークダウンのプランファイルに代わり、依存関係を認識したタスクグラフを用いることで、エージェントが長期タスクをコンテキスト喪失なく処理できるようにする。Dolt（バージョン管理付きSQLデータベース）をストレージバックエンドとして採用し、Go言語（94.1%）で実装されている。

スター数：21.6k／フォーク数：1.4k

先行研究と比べてどこがすごい？

従来のエージェント向けタスク管理は、AGENTS.mdやTODO.mdのようなマークダウンファイルに依存しており、依存関係の追跡・マルチエージェント競合・長期コンテキスト維持が困難だった。Beadsはこれに対し以下の優位性を持つ。

Doltによるバージョン管理付きSQLで、セルレベルのマージ・ネイティブブランチ・リモート同期を実現

ハッシュベースID（bd-a1b2形式）によりマルチエージェント/マルチブランチ環境でもマージ競合をゼロに抑制

セマンティックな「メモリ減衰（Memory Decay）」機能により、古いクローズ済みタスクを要約してコンテキストウィンドウの節約が可能

技術や手法のキモはどこ？

Dolt統合：SQLベースのストレージ。Embedded Mode（デフォルト、プロセス内実行）とServer Mode（外部dolt sql-server接続、複数ライター対応）の2モード

グラフ構造：relates_to/duplicates/supersedes/replies_toリンクによるナレッジグラフ構築

階層型ID：bd-a3f8（Epic）→ bd-a3f8.1（Task）→ bd-a3f8.1.1（Sub-task）の3層構造

Compaction：クローズ済みタスクの意味的要約によるコンテキスト圧縮

Gitフリー動作：BEADS_DIR環境変数と--stealthフラグで.gitディレクトリなしでも動作。Sapling・Jujutsu・CI/CDなど非git環境に対応

エージェント最適化：JSON出力・依存追跡・自動ready検出（bd readyコマンド）

どうやって有効だと検証した？

公開リポジトリ（21.6kスター）での実運用実績と、BENCHMARKS.mdにベンチマーク記録あり。Claude Code・GitHub Copilotとの統合ドキュメントが整備されており、実際のAIエージェントワークフローでの採用を前提とした設計検証が行われている。

議論はある？

Embedded Modeはシングルライター制限（ファイルロック）あり。複数エージェントの並行書き込みにはServer Modeが必要で、設定コストが増す。Gitフリーモードではdaemon起動に制限あり（PR #433で対応中）。macOSでの署名処理（再署名のオプトイン）や、Windowsでのアンチウイルス誤検知（ANTIVIRUS.md参照）など、バイナリ配布に関わる運用課題が残存。