gastownhall/beads

Beads - A memory upgrade for your coding agent

解決する課題

Beads は、AIエージェント向けに特別に設計された、永続的で構造化されたメモリおよびイシュートラッキングシステムを提供します。非構造化された Markdown ベースのプランを、依存関係を認識するグラフに置き換えることで、エージェントが長期的なタスク中にコンテキストを失うのを防ぎ、煩雑な TODO リストの必要性を排除します。

仕組み

Beads は、バージョン管理された SQL データベース（Dolt が提供）を使用して、タスクとメモリを保存します。CLI ツールとして動作し、エージェントは依存関係（例：blocks, relates-to）を追跡しながら、タスクの作成、割り当て、および完了を行うことができます。また、構造化された JSON 出力と、必要なワークフローのコンテキストや永続メモリをエージェントのプロンプトに注入する bd prime コマンドを提供することで、さまざまな AI エージェント（Claude Code、Codex、Factory.ai など）と統合できます。

対象ユーザー

タスク管理に単純なテキストファイルを使用することから脱却し、エージェントにプロジェクトの進捗に関する信頼性の高いバージョン管理されたナレッジグラフを提供したい開発者や AI エージェント・オーケストレーター。

ハイライト

  • Dolt 駆動のストレージ: セルレベルのマージとネイティブなブランチ機能を備えたバージョン管理 SQL データベースを使用し、コンフリクトのないマルチエージェント・ワークフローを実現します。
  • エージェントに最適化: JSON 出力と、「準備完了」タスク（未解決のブロッカーがないタスク）の自動検出機能を備えています。
  • セマンティック・メモリ減衰: 古い完了済みタスクを要約してコンテキストウィンドウのスペースを節約する、コンパクション（圧縮）機能が含まれています。
  • 柔軟なデプロイ: 組み込み型とサーバーベースのストレージモードの両方をサポートし、Git なしでも完全に動作可能です。
  • 階層的なタスク管理: 階層 ID（例：bd-a3f8.1.1）を介して、エピックとサブタスクをサポートします。