epic

---

description: Epic management commands argument-hint: "[command]"

Manage epics (large features composed of multiple issues).

Available Commands

• status: Show epic completion status

  • Shows progress for each epic
  • Lists child issues and their states
  • Calculates completion percentage

• close-eligible: Close epics where all children are complete

  • Automatically closes epics when all child issues are done
  • Useful for bulk epic cleanup

Epic Workflow

1. Create epic: bd create "Large Feature" -t epic -p 1
2. Link subtasks: bd dep add bd-20 bd-10 --type parent-child (task bd-20 is child of epic bd-10)
   • Or at creation: bd create "Subtask title" -t task --parent bd-10
   • Children inherit parent labels by default. If the epic uses size/effort labels and children should have their own, add --no-inherit-labels (GH#4562).
3. Track progress: bd epic status
4. Auto-close when done: bd epic close-eligible

Epics use parent-child dependencies to track subtasks.