Files
beads/commands/dep.md
Steve Yegge 7658c4a8e8 Add command documentation and improve daemon UX
- Added human-readable uptime formatting (51m 59s vs 3119.4 seconds)
- Fixed daemon stop race condition with SIGKILL
- Added markdown docs for 19 commands: blocked, comments, compact, daemon,
  delete, dep, epic, export, import, label, list, quickstart, rename-prefix,
  renumber, reopen, repos, restore, stale, sync
- Closed: bd-159, bd-152, bd-168
- Deleted test issues: bd-144, bd-145

Amp-Thread-ID: https://ampcode.com/threads/T-9f7c3fed-62de-4bcd-a059-8c1b77cdb841
Co-authored-by: Amp <amp@ampcode.com>
2025-10-19 22:24:14 -07:00

985 B

description: Manage dependencies between issues argument-hint: [command] [from-id] [to-id]

Manage dependencies between beads issues.

Available Commands

  • add: Add a dependency between issues

    • $1: "add"
    • $2: From issue ID
    • $3: To issue ID
    • $4: Dependency type (blocks, related, parent-child, discovered-from)
  • remove: Remove a dependency

    • $1: "remove"
    • $2: From issue ID
    • $3: To issue ID
  • tree: Show dependency tree for an issue

    • $1: "tree"
    • $2: Issue ID
  • cycles: Detect dependency cycles

Dependency Types

  • blocks: Hard blocker (from blocks to) - affects ready queue
  • related: Soft relationship - for context only
  • parent-child: Epic/subtask relationship
  • discovered-from: Track issues found during work

Examples

  • bd dep add bd-10 bd-20 --type blocks: bd-10 blocks bd-20
  • bd dep tree bd-20: Show what blocks bd-20 and what bd-20 blocks
  • bd dep cycles: Check for circular dependencies