CLI reference

heddle diff

Shipped

heddle diff [OPTIONS] [FROM] [TO] [-- <PATH>...]

Show what changed in the worktree, a thread, or two states

Output text (default) · json · json-compact

Arguments

[FROM] value optional: Base state (default: HEAD). A path-shaped value is a worktree filter
[TO] value optional: Target state (default: worktree). A path-shaped value is a worktree filter
[PATH] value optional: Paths after `--`. Always treated as worktree/path filters

--base <BASE>: Select an additional diff base. `last-turn` uses the first capture in the live harness session on this thread. With this set, one state positional names the target rather than another base values: last-turn
--path <PATH>: Restrict the diff to these repository-relative paths
--semantic <SEMANTIC>: Show semantic changes values: true · false
--stat <STAT>: Show diffstat summary only values: true · false
--name-only <NAME_ONLY>: Show only changed file names values: true · false
--unified <UNIFIED>, -U <UNIFIED>: Number of surrounding context lines to include in each hunk default: 3
--context <CONTEXT>: Show concise applicable context alongside diff output values: true · false
--patch <PATCH>, -p <PATCH>: Output a Git-compatible unified diff values: true · false

worktree vs HEAD

bash$ heddle diff

worktree vs this agent peer's turn start

bash$ heddle diff --base last-turn

only that path

bash$ heddle diff NOTES.md

same, after the path separator

bash$ heddle diff -- NOTES.md

same, explicit path filter

bash$ heddle diff --path NOTES.md

two states, filtered to src/

bash$ heddle diff HEAD~1 HEAD -- src