> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bd diff

> Show changes between two commits or branches

Generated from `bd help --doc diff`.

Show the differences in issues between two commits or branches.

The refs can be:

* Commit hashes (e.g., abc123def)
* Branch names (e.g., main, feature-branch)
* Special refs like HEAD, HEAD\~1

Examples:
bd diff main feature-branch   # Compare main to feature branch
bd diff HEAD\~5 HEAD           # Show changes in last 5 commits
bd diff abc123 def456         # Compare two specific commits

```
bd diff <from-ref> <to-ref> [flags]
```