heddle diff

With no arguments, diff compares HEAD to the working tree. Give it one state to diff that state against the worktree, or two to diff a pair.

--semantic renders AST-item-level changes rather than lines, which is the form worth reading when an agent has moved code around. --patch emits a Git-compatible unified diff for tools that expect one; --stat and --name-only give the summary shapes. --context adds the applicable context annotations alongside the diff, so the reasoning attached to a symbol travels with the change to it.

Arguments

[FROM] state optional

Base state. default: HEAD

[TO] state optional

Target state. default: worktree

Flags

--semantic

Show semantic changes.

--stat

Show diffstat summary only.

--name-only

Show only changed file names.

--unified <n>, -U <n>

Number of surrounding context lines to include in each hunk. default: 3

--context

Show concise applicable context alongside diff output.

--patch, -p

Output a Git-compatible unified diff.

Examples

What has changed since the last capture

bash$ heddle diff --stat

Semantic diff between two states, with the reasoning

bash$ heddle diff hd-9a2fk3xqr7tv hd-9c41m8bzp2hd --semantic --context

See also

• heddle status
• heddle show
• heddle log