beads_viewer (bv) の新バージョンには、本当に全力を尽くしました。bv のオリジナルバージョンはたった1日で開発し、Go言語で7,000行弱でした。今回の新バージョンは…80,000行です。素晴らしい機能を山ほど追加しました。きっとあなたのエージェントも、そしてあなたも、きっと気に入ってくれるでしょう。
gh ユーティリティを使用してビーズを GitHub ページの静的サイトに自動的にエクスポートできる機能のスクリーンショットをいくつか示します。
ここで、beads_viewer プロジェクト自体のライブ例を試すことができます (とてもメタです!): https://t.co/UhboFtbSdZ
TUI にも数多くの機能強化と、数多くの新しい便利な機能が追加されました。
しかし、実際の有用性という点で最も大きな改善は、あなた方人間のためではありません！コーディングエージェントのためです。 簡単なコマンド bv --robot-triage を実行するだけで、次に何に取り組むべきかについての膨大な情報を瞬時に得ることができます。
AGENTS dot mdファイル内のblurbを必ず更新してください（ただし、ツールはこれを自動的に検出し、追加するかどうかを尋ねてきます）。新しいblurbは長くなりますが、追加のコンテキストウィンドウトークンの価値は十分にあります。 ### bv を AI サイドカーとして使用する bv は、Beads プロジェクト (.beads/beads.jsonl) 用のグラフを考慮したトリアージエンジンです。JSONL を解析したり、複雑なグラフトラバーサルを実行したりする代わりに、ロボットフラグを使用して、事前に計算されたメトリクス (PageRank、媒介性、クリティカルパス、サイクル、HITS、固有ベクトル、k-core) に基づく決定論的で依存関係を考慮した出力を生成します。 **スコープ境界:** bvは*作業内容*（トリアージ、優先順位付け、計画）を担当します。エージェント間の調整（メッセージング、作業の請求、ファイルの予約）には、[MCPエージェントメール](https://t.co/vi3HxBUknU)をご利用ください。 **⚠️ 重要: `--robot-*` フラグのみを使用してください。`bv` のみを使用すると、セッションをブロックする対話型 TUI が起動します。** #### ワークフロー: トリアージから始める **`bv --robot-triage` は単一のエントリ ポイントです。** 1 回の呼び出しで必要なものがすべて返されます。 - `quick_ref`: 一目でわかるカウント + トップ 3 のピック - `推奨事項`: スコア、理由、ブロック解除情報とともに実行可能な項目をランク付けします - `quick_wins`: 労力は少なく、影響度は高いアイテム - `blockers_to_clear`: 最も下流の作業をブロック解除する項目 - `project_health`: ステータス/タイプ/優先度の分布、グラフメトリクス - `commands`: 次のステップのためにシェルコマンドをコピー＆ペーストします bv --robot-triage # メガコマンド:ここから始める bv --robot-next # 最小限: 単一のトップピック + クレームコマンドのみ #### その他のコマンド **計画:** | コマンド | 戻り値 | |---------|----------| | `--robot-plan` | `unblocks` リストを使用して並列実行を追跡します | | `--robot-priority` | 信頼性のある優先度の不一致検出 | **グラフ分析:** | コマンド | 戻り値 | |---------|----------| | `--robot-insights` | 完全なメトリクス: PageRank、媒介性、HITS (ハブ/オーソリティ)、固有ベクトル、クリティカル パス、サイクル、k コア、アーティキュレーション ポイント、スラック | | `--robot-label-health` | ラベルごとのヘルス: `health_level` (healthy\|warning\|critical)、`velocity_score`、`staleness`、`blocked_count` | | `--robot-label-flow` | ラベル間の依存関係: `flow_matrix`、`dependencies`、`bottleneck_labels` | | `--robot-label-attention [--attention-limit=N]` | 注目度ランク付けされたラベル: (ページランク × 古さ × ブロックの影響) / 速度 | **履歴と変更の追跡:** | コマンド | 戻り値 | |---------|----------| | `--robot-history` | ビーズとコミットの相関関係: `stats`、`histories` (ビーズごとのイベント/コミット/マイルストーン)、`commit_index` | | `--robot-diff --diff-since ` | ref 以降の変更: 新規/クローズ/変更された問題、導入/解決されたサイクル | **その他のコマンド:** | コマンド | 戻り値 | |---------|----------| | `--robot-burndown ` | スプリントのバーンダウン、スコープの変更、リスクのある項目 | | `--robot-forecast ` | 依存関係を考慮したスケジュールによる ETA 予測 | | `--robot-alerts` | 古い問題、カスケードのブロック、優先順位の不一致 | | `--robot-suggest` | 衛生: 重複、依存関係の欠落、ラベルの提案、サイクルの中断 | | `--robot-graph [--graph-format=json\|dot\|mermaid]` | 依存関係グラフのエクスポート | | `--export-graph ` | 自己完結型のインタラクティブな HTML 視覚化 | #### スコープとフィルタリング bv --robot-plan --label backend # ラベルのサブグラフへのスコープ bv --robot-insights --as-of HEAD~30 # 履歴時点 bv --recipe actionable --robot-plan # 事前フィルター: 作業準備完了 (ブロッキングなし) bv --recipe high-impact --robot-triage # 事前フィルター: 上位 PageRank スコア bv --robot-triage --robot-triage-by-track # 並列作業ストリームごとにグループ化 bv --robot-triage --robot-triage-by-label # ドメイン別にグループ化 #### ロボットの出力を理解する **すべてのロボット JSON には以下が含まれます:** - `data_hash` — ソースbeads.jsonlのフィンガープリント（呼び出し間の一貫性を検証） - `status` — メトリックごとの状態: `computed|approx|timeout|skipped` + 経過時間 (ms) - `as_of` / `as_of_commit` — `--as-of` 使用時に存在。ref と解決済みの SHA を含む。 **2相分析:** - **フェーズ 1 (即時):** 度、地形分類、密度 — いつでもすぐに利用可能 - **フェーズ2（非同期、500msタイムアウト）:** PageRank、媒介性、HITS、固有ベクトル、サイクル - `status`フラグをチェック **大規模なグラフ（500ノード以上）の場合:** 一部のメトリックは近似値として扱われるか、スキップされる可能性があります。常に「ステータス」を確認してください。 #### jq クイックリファレンス bv --robot-triage | jq '.quick_ref' # 一目でわかる概要 bv --robot-triage | jq '.recommendations[0]' # 上位の推奨事項 bv --robot-plan | jq '.plan.summary.highest_impact' # 最適なブロック解除ターゲット bv --robot-insights | jq '.status' # メトリックの準備状況を確認する bv --robot-insights | jq '.Cycles' # 循環依存関係 (修正必須!) bv --robot-label-health | jq '.results.labels[] | select(.health_level == "critical")' **パフォーマンス:** フェーズ1は即時実行、フェーズ2は非同期（タイムアウト500ms）。速度が重要な場合は、`--robot-insights`よりも`--robot-plan`を優先してください。結果はデータハッシュによってキャッシュされます。 beads.jsonl を解析する代わりに bv を使用します。これは、PageRank、クリティカル パス、サイクル、並列トラックを決定論的に計算します。
とにかく、感想を聞かせてください！bvはここから入手できます。いつでも無料で、100%MITライセンスのオープンソースで、エージェントコーディングのための7つのツールフライホイールの一部です。 https://t.co/pGNHTEqQHH
改良された私の個人ウェブサイトでフライホイールを探索できます。私は他の作業に取り組んでいる間に、エージェントが私のためにカスタマイズしてくれるのを楽しんでいます。彼らが私に説明したツールがまさにそれです: https://t.co/2usm1h4hUf