gastownhall/beads

これは何？

主な機能

• 01タスクを依存関係グラフとして保存し、`bd ready`でブロッカーのない作業を一覧表示します。
• 02マルチエージェントのワークフロー向けに、`bd update --claim`でタスクをアトミックに引き受けられます。
• 03ハッシュベースのIDとDoltのブランチ機能により、ブランチ間のマージ競合を減らします。
• 04エピックやサブタスクに使える階層型IDと、グラフリンクの種類をサポートします。
• 05セマンティック圧縮により、完了済みの古いタスクを要約してコンテキストウィンドウを節約します。
• 06Gitなしでの動作と、Claude Code、Codex、Cursorとの連携に対応します。

ユースケース

• 長期にわたる複数ステップのプロジェクトで、コーディングエージェントに永続的なタスク記憶を持たせる。
• 同じリポジトリで異なるブランチを使って作業する複数のエージェントを調整する。
• オープンソースプロジェクトへの貢献時に、計画上の課題を別途管理する。
• CI環境やGit以外のバージョン管理環境で、独立したタスク管理を実行する。

クイックスタート

1. 1

   bd CLIをシステム全体にインストールする

   README の公式手順に従ってインストール
2. 2

   プロジェクトディレクトリに移動する

   cd your-project
3. 3

   プロジェクトでbeadsを初期化する

   bd init

使う前に知っておきたいこと

• !Doltをバックエンドとするデータベースが必要で、チームが理解しておくべき依存関係が追加されます。
• !HTTPバックエンドの動作にはローカルモードと異なる点がいくつかあり、実験的機能として文書化されています。
• !安全に手動インストールするには、インストールスクリプトとバイナリの検証手順が必要です。

トピック

よくある質問

beads とは？

bd CLIで、コーディングエージェントに永続的で依存関係を把握できるタスク記憶を提供する、Doltベースの分散型グラフ課題トラッカー。 Beads（`bd` CLI）は、AIコーディングエージェント向けに作られた課題トラッカーです。計画をばらばらのMarkdownファイルに保存するのではなく、バージョン管理可能なSQLデータベースに、依存関係を把握できるグラフとしてタスクを保存します。エージェントは、未解決のブロッカーがないタスクを取得し、タスクをアトミックに引き受けて完了にできます。タスクを完了すると依存先のタスクが着手可能になるため、コンテキストを失わずに長期的な作業を管理できます。

beads は無料で使えますか？ライセンスは？

beads は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

beads は今もメンテナンスされていますか？

活発にメンテナンス中。beads の最終コミットは 2026年10月19日 です。

beads は何に使えますか？

長期にわたる複数ステップのプロジェクトで、コーディングエージェントに永続的なタスク記憶を持たせる。 同じリポジトリで異なるブランチを使って作業する複数のエージェントを調整する。 オープンソースプロジェクトへの貢献時に、計画上の課題を別途管理する。 CI環境やGit以外のバージョン管理環境で、独立したタスク管理を実行する。

beads のインストール方法は？

bd CLIをシステム全体にインストールする プロジェクトディレクトリに移動する: cd your-project プロジェクトでbeadsを初期化する: bd init

beads はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/gastownhall/beads