beads

Beads イシュートラッカー

依存関係を考慮した Git ベースのイシュートラッキング。エージェントのタスク管理に最適です。

前提条件

beads をインストールします:

# Install via cargo or download binary
cargo install beads
# Or download from releases

プロジェクト内で初期化します:

bd init

CLI リファレンス

着手可能な作業を表示

# Get issues with no blockers
bd ready --json

# Filter by assignee
bd ready --assignee username --json

# Filter by label
bd ready --label "urgent" --json

# Limit results
bd ready --limit 5 --json

イシューを作成

# Basic task
bd create "Task title" --json

# With details
bd create "Task title" -d "Description" -t task -p 2 --json

# As subtask of epic
bd create "Subtask" --parent epic-123 --force --json

# With dependencies
bd create "Task" --deps "other-issue-id" --json

# Quick mode (less output)
bd create "Task" -q --json

イシューの種類

• bug - バグ報告
• feature - 新機能
• task - 一般的なタスク
• epic - 親コンテナ
• chore - メンテナンス作業

優先度レベル

• 0 - 緊急
• 1 - 高
• 2 - 通常 (デフォルト)
• 3 - 低
• 4 - バックログ

イシューを更新

# Change status
bd update issue-id -s in_progress --json

# Add notes
bd update issue-id --notes "Progress update" --json

# Change priority
bd update issue-id -p 1 --json

# Add labels
bd update issue-id --add-label "urgent" --json

イシューをクローズ

# Close with reason
bd close issue-id -r "Completed successfully" --json

イシューを一覧表示

# All open issues
bd list --status open --json

# Filter by type
bd list --type bug --json

# Filter by assignee
bd list --assignee "username" --json

# Filter by label
bd list --label "backend" --json

# Filter by priority
bd list --priority 1 --json

イシューの詳細を表示

bd show issue-id --json

依存関係

# Add dependency (issue-a depends on issue-b)
bd dep add issue-a issue-b

# Dependency types: blocks, related, parent-child, discovered-from
bd dep add issue-a issue-b -t blocks

Git と同期

# Sync issues to git remote
bd sync

衛生管理コマンド

# Find duplicate issues
bd duplicates --dry-run

# Auto-merge duplicates
bd duplicates --auto-merge

# Find stale issues (no activity)
bd stale --days 14 --json

# Cleanup old closed issues
bd cleanup --dry-run
bd cleanup -f

Git フックをインストール

# Auto-sync on commit
bd hooks install

システム情報

# Check version
bd --version

# Project info
bd info --json

ワークフローパターン

セッション開始

# See what's ready to work on
bd ready --json

タスクに取り組む

# Start working
bd update task-id -s in_progress --json

# Add progress notes
bd update task-id --notes "Halfway done" --json

# Complete
bd close task-id -r "Implemented and tested" --json

エピックの計画

# Create epic
bd create "User Authentication" -t epic --json

# Add subtasks
bd create "Design auth flow" --parent auth-epic --force --json
bd create "Implement login" --parent auth-epic --force --json
bd create "Add tests" --parent auth-epic --force --json

# Add dependencies between subtasks
bd dep add implement-id design-id -t blocks
bd dep add tests-id implement-id -t blocks

セッション終了

# Sync to git
bd sync

ワークツリーモード

git worktree を使用する場合は、デーモンを無効にします:

export BEADS_NO_DAEMON=1
# Or per-command
bd --no-daemon ready --json

ベストプラクティス

1. 常に --json を使用する - 解析可能な出力のため
2. セッション開始時に bd ready を使用する - ブロックされていない作業を確認するため
3. 依存関係を追加する - タスクの関係を表現するため
4. エピックを使用する - 関連するタスクをグループ化するため
5. セッション終了前に bd sync を実行する
6. フックをインストールする - 自動同期のため: bd hooks install