Beadsとは？
Beadsは、コーディングエージェントが書き散らすmarkdownのToDoリストを、エージェントが問い合わせられる小さなissueトラッカーに置き換えます。各タスクにはbd-a1b2のようなハッシュベースのIDが付き、タスク同士はブロッカー、親、重複として結び付きます。`bd ready`は手前に未完了のものがない作業だけを一覧します。エージェントは`bd update --claim`でタスクを引き受け（担当者と状態を一度に設定）、`bd close`で閉じると、そのタスクがブロックしていたものが解放されます。`bd remember`はプロジェクトの事実を保存し、`bd prime`が次のセッションの開始時にそれを戻します。
保存先はバージョン管理されたSQLデータベースのDoltです。初期設定ではCLIに組み込まれて書き込み手は1つだけ、サーバーモードではdolt sql-serverに接続して複数が同時に書き込めます。マシン間は既存のgitリモート上のrefに対して`bd dolt push`と`bd dolt pull`で同期します。`bd init`はAGENTS.mdに手順も書き込み、Claude Code、Codex、Cursor向けのフックを導入します。プロジェクトはsteveyegge/beadsからgastownhall組織に移り、古いパスはリダイレクトされます。
Beadsは使う価値があるか？
Beadsは狭い問題をうまく解決します。月曜に立てた計画を火曜には忘れているエージェントです。古くなっていくPLAN.mdの代わりに、エージェントは`bd ready --json`でブロックされていない作業を尋ね、見つけたことを新しいタスクとして記録します。リポジトリのGitHubスターは約28,700で、2026年4月3日にv1.0.0に達し 、11月4日にv1.3.4を出し、11月13日にはv1.4.0のリリース候補が公開されました。
きれいにマージできるのはDoltバックエンドのおかげです。ハッシュIDのため、2つのブランチ上の2つのエージェントが同じタスク番号を作ることはなく、Doltは行をテキストの行としてではなくセル単位でマージします。初期設定の組み込みモードはデータベースを.beads/に置き、書き込み手は一度に1つです。複数のエージェントが同時に書くにはサーバーモードが必要です。.beads/issues.jsonlはビューア向けのエクスポートでバックアップではないため、gitにただのファイルがあると思っていた人は驚きます。
初期設定では静かです。OpenTelemetryのエクスポートはBD_OTEL_ENABLEDを設定しない限りオフで、モデルの呼び出しは任意のコマンドでしか起きません。古い完了タスクを要約してコンテキストを節約する圧縮と、AIによる重複検出は、どちらも初期設定で自分のAnthropicキーを使ってClaude Haiku 4.5を呼びます（もう一つの対応プロバイダーはMiniMaxです）。悪意あるリポジトリへの対策もあり、コミットされた.beads/.envではコマンドや認証ヘルパーを設定できず、実験的なHTTPクライアントはローカル以外のサーバーに暗号化されていないhttpでトークンを送ることを拒否します。
注意点：変化の速さです。トラッカーには未解決のissueが約1,070件、オープンなプルリクエストが697件あり、アップグレードにはスキーマ移行が含まれることがあります。共有データベースでは、指定した1つのクローンが先に移行を実行し、ほかのクローンはその後でbootstrapする必要があります。Ian Bullは1月に公開した長いレビューで、指示しなければClaude はBeadsを無視し、CLAUDE.mdの指示は長いセッションの途中で薄れていくと書いています。フックや明示的な指示は今も必要です。
結論：短いタスクを1つのエージェントでこなすならmarkdownのチェックリストで足ります。エージェントが2つ、マシンが2台、あるいは1週間がかりのリファクタリングになったら、Beadsは計画をエージェントが問い合わせられ、gitが運べる形で保ちます。
真価を発揮する場面
Claude Codeで1週間がかりの移行作業をする個人開発者
昨日のセッションが止まったところからそのまま再開する
`bd init`を実行してClaude Code用のフックを入れます。エージェントは見つけた問題を一つずつタスクとして登録し、翌朝は`bd prime`が未完了の作業を戻します。圧縮は任意なので、エージェント以外の費用はかかりません。
別々のブランチとノートPCでエージェントを動かす4人のチーム
計画ファイルのマージ衝突なしに1つのタスクグラフを共有する
`bd init --server`で同時書き込み用のdolt sql-serverを立て、チームのgitリモートに対して`bd dolt push`と`bd dolt pull`で同期します。アップグレードのたびに1人が先にスキーマ移行を実行する必要があるため、チームの運用手順書に書いておく価値があります。
オープンソースプロジェクトのコントリビューター
他人のリポジトリにファイルを足さずに自分の計画を管理する
`bd init --stealth`でBeadsをローカルだけに置き、`bd init --contributor`で計画用のタスクを別のリポジトリに回せば、プルリクエストにはコードだけが載ります。
導入前に確認すること
- 導入
- `brew install beads`または`npm install -g @beads/bd`のあと、プロジェクトで`bd init`を実行します。--skip-agentsか--stealthを付けない限り、AGENTS.mdへの手順とエージェント用フックを書き込みます。
- 連携
- `bd setup`でClaude Code、Codex、Cursor、Factory Droidに対応。PyPIのbeads-mcpサーバー、どのエージェントでも使えるJSON出力、`bd serve`と`bd connect`による実験的なHTTPバックエンド。
- データとプライバシー
- タスクは.beads/配下のDoltデータベースにあり、gitリモート上のrefと同期します。テレメトリーはOpenTelemetryによるオプトインです。圧縮とAI重複検出は、キーを指定して実行した場合にのみタスクのテキストをAnthropic かMiniMaxに送ります。
- 大規模利用時のコスト
- ソフトウェアは無料です。圧縮にはClaude Haiku 4.5のトークン代がかかり、同時書き込み用のDoltサーバーは自前のインフラで動かします。
- 制限
- 組み込みモードは書き込み手が1つ。スキーマ移行には調整したアップグレードが必要で、HTTPバックエンドは実験的で一部の操作を拒否します。未解決のissueは約1,070件です。
良い点
- `bd ready`がブロックされていない作業だけをJSONでエージェントに渡す
- ハッシュIDとDoltのセル単位マージでブランチ間のタスク衝突を防ぐ
- すでにあるgitリモートで同期できる
- テレメトリーは初期設定でオフ、モデル呼び出しは任意のコマンドのみ
気になる点
- 組み込みモードは書き込み手が1つだけで、並列エージェントにはDoltサーバーが必要
- 共有データベースではスキーマ移行のために調整したアップグレードが必要
- 未解決のissueが約1,070件、オープンなプルリクエストが697件
- 一貫して使わせるには今もフックや指示が必要
おすすめの人
Claude Code、Codex、あるいは複数のエージェントで数日がかりの作業を進め、計画をmarkdownではなく問い合わせ可能なタスクとして保存したい開発者。
Beadsの代替
Beads：よくある質問
- Beadsは使う価値があるか？
- Beadsはセッションの終了にもブランチのマージにも耐えるタスクリストをコーディングエージェントに与えますが、その代わりにデータベース、頻繁なスキーマ移行、混み合った自前のissueトラッカーを引き受けることになります。 評価は5点満点中4.0点です。
- Beadsの料金は？
- 無料のオープンソース（MIT）。任意の圧縮機能とAIによる重複検出は、自分のAnthropicまたはMiniMaxのキーでモデルを呼び出します。
- Beadsの欠点は？
- 組み込みモードは書き込み手が1つだけで、並列エージェントにはDoltサーバーが必要; 共有データベースではスキーマ移行のために調整したアップグレードが必要; 未解決のissueが約1,070件、オープンなプルリクエストが697件; 一貫して使わせるには今もフックや指示が必要.
- Beadsは誰に向いているか？
- Claude Code、Codex、あるいは複数のエージェントで数日がかりの作業を進め、計画をmarkdownではなく問い合わせ可能なタスクとして保存したい開発者。
- チームや本番環境でBeadsを使うと費用はいくらか？
- ソフトウェアは無料です。圧縮にはClaude Haiku 4.5のトークン代がかかり、同時書き込み用のDoltサーバーは自前のインフラで動かします。
- Beadsは企業データを扱っても安全か？
- タスクは.beads/配下のDoltデータベースにあり、gitリモート上のrefと同期します。テレメトリーはOpenTelemetryによるオプトインです。圧縮とAI重複検出は、キーを指定して実行した場合にのみタスクのテキストをAnthropicかMiniMaxに送ります。
- Beadsの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はclaude-mem, Vibe Kanban 、 Spec Kitです。
回答確認日：2026年11月13日
Beadsの開発元の方へ：この評価をサイトに掲載できます
