gastownhall/beads：README に基づく導入ガイド

gastownhall/beads の README はプロジェクトを「Beads - A memory upgrade for your coding agent」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「bd - Beads」には次の説明があります。Distributed graph issue tracker for AI agents, powered by Dolt.。これは範囲の説明であり、本番検証の結果ではありません。

README の「🛠 Features」にある内容から、用途が合うかを先に判断できます。Agent-Optimized: JSON output, dependency tracking, and auto-ready task detection.。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。Dolt-Powered: Version-controlled SQL database with cell-level merge, native branching, and built-in sync via Dolt remotes.。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「⚡ Quick Start」など複数の箇所に分かれています。確認できる情報は次の通りです。Note: Beads is a CLI tool you install once and use everywhere. You don't need to clone this repository into your project.。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 # Install beads CLI (system-wide - don't clone this repo into your project) curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash # Initialize in YOUR project cd your-project bd init # Optional: refresh or install richer instructions for your agent bd setup codex # Codex CLI - installs skill, AGENTS.md guidance, and hooks bd setup claude # Claude Code - installs hooks/settings bd setup factory # Factory.ai Droid - creates/updates AGENTS.md 実行可能なコマンドがない場合は手順を作らず、「⚡ Quick Start」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「⚡ Quick Start」にはbd init creates or updates AGENTS.md by default so agents can discover the beads workflow, and also installs project Claude/Codex integrations unless you pass --skip-agents or --stealth.とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはZero Conflict: Hash-based IDs (bd-a1b2) prevent merge collisions in multi-agent/multi-branch workflows.ともあります。