mcpField
B
beads

beads

github.com/gastownhallエージェントワークフロー28.3k2.1k 回インストール今日更新
リポジトリ

beads について

Beads は、複数のセッションにまたがる作業を管理する AI エージェント向けのグラフ型課題トラッカーです。課題の状態や依存関係を保持し、Dolt によるチーム同期で会話の圧縮後も作業コンテキストを引き継げます。

主な機能

  1. 01課題の永続的な追跡
  2. 02依存関係に基づく作業計画
  3. 03会話圧縮後の作業再開
  4. 04Dolt によるチーム同期
  5. 05JSON コマンド出力

活用シーン

  1. 01複数セッションにわたる機能開発の追跡
  2. 02未着手可能なタスクの検索と担当開始
  3. 03会話圧縮後の進行中作業の復元

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gastownhall/beads --skill beads

インストール後、Claude Code で/beadsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CLAUDE.md
adr/
0001-bd-prime-as-source-of-truth.md
agents/
openai.yaml
commands/
audit.md
blocked.md
close.md
comments.md
compact.md
create.md
decision.md
delete.md
dep.md
epic.md
export.md
import.md
init.md
label.md
list.md
prime.md
quickstart.md
ready.md
rename-prefix.md
reopen.md
restore.md
search.md
show.md
stats.md
sync.md
template.md
update.md

詳細

Beads - AI エージェント向け永続タスクメモリ

会話の圧縮後も残る、グラフベースの課題トラッカーです。複雑な依存関係を伴う複数セッションの作業に、永続メモリを提供します。

bd と TodoWrite の比較

判断基準：「このコンテキストが2週間後にも必要ですか？」はい＝bd、いいえ＝TodoWrite。

bd（永続的）TodoWrite（一時的）
複数セッション、依存関係、圧縮後も維持単一セッションの直線的なタスク
Dolt によるチーム同期会話単位

詳しい比較については、BOUNDARIES.md を参照してください。

前提条件

bd --version  # Requires v0.60.0+
  • bd CLI がインストールされ、PATH に含まれていること
  • Git リポジトリ（任意 — Git を使わずに運用する場合は BEADS_DIR と --stealth を使用）
  • 初期化：bd init を一度実行すること（人間が実行し、エージェントは実行しません）

CLI リファレンス

bd prime を実行すると、AI 向けに最適化されたワークフローのコンテキストが得られます（フックによって自動的に読み込まれます）。 特定のコマンドの使い方については、bd <command> --help を実行してください。

基本的なコマンド：bd ready、bd create、bd show、bd update、bd close、bd dolt push

セッションプロトコル

  1. bd ready — ブロックされていない作業を探します
  2. bd show <id> — コンテキスト全体を取得します
  3. bd update <id> --claim — 作業を確保し、アトミックに開始します
  4. 作業中にメモを追加します（圧縮後も作業を維持するために重要です）
  5. bd close <id> --reason "..." — タスクを完了します
  6. bd dolt push — Dolt リモートにプッシュします（設定されている場合）

出力

構造化出力を得るには、任意のコマンドに --json を追加します。拡張メタデータを確認するには、bd show <id> --long を使用します。ステータスアイコン：○ オープン ◐ 進行中 ● ブロック中 ✓ クローズ ❄ 延期。

エラー処理

エラー対処方法
database not foundプロジェクトのルートで bd init <prefix> を実行します
not in a git repository先に git init を実行します
disk I/O error (522).beads/ をクラウド同期対象のファイルシステムから移動します
ステータス更新の反映が遅いサーバーモードを使用します：bd dolt start

詳しくは TROUBLESHOOTING.md を参照してください。

例

複数セッションにわたる機能を追跡する：

bd create "OAuth integration" -t epic -p 1 --json
bd create "Token storage" -t task --deps blocks:oauth-id --json
bd ready --json                    # Shows unblocked work
bd update <id> --claim --json      # Claim and start
bd close <id> --reason "Implemented with refresh tokens" --json

圧縮後に作業を再開する： bd list --status in_progress --json を実行し、その後 bd show <id> --long を実行します

作業中に見つかった作業項目を登録する： bd create "Found bug" -t bug -p 1 --deps discovered-from:<current-id> --json

高度な機能

機能CLIリソース
Molecules（テンプレート）bd mol --helpMOLECULES.md
Chemistry（pour/wisp）bd pour、bd wispCHEMISTRY_PATTERNS.md
エージェント用 Beadsbd agent --helpAGENTS.md
非同期ゲートbd gate --helpASYNC_GATES.md
ワークツリーbd worktree --helpWORKTREES.md

リソース

カテゴリファイル
はじめにBOUNDARIES.md、CLI_REFERENCE.md（最新のリファレンスへのリンク）、WORKFLOWS.md
基本概念DEPENDENCIES.md、ISSUE_CREATION.md、PATTERNS.md
回復力RESUMABILITY.md、TROUBLESHOOTING.md
高度な機能MOLECULES.md、CHEMISTRY_PATTERNS.md、AGENTS.md、ASYNC_GATES.md、WORKTREES.md
リファレンスSTATIC_DATA.md、INTEGRATION_PATTERNS.md

検証

bd --version が 0.60.0 より新しいバージョンを示す場合、このスキルは古くなっている可能性があります。最新の CLI ガイダンスを確認するには bd prime を実行してください。これは bd のリリースごとに自動更新される、正式な信頼できる情報源です（ADR-0001）。

コメント

Markdown 対応