CLI Reference · Current

Local diff

Inspect working-tree or staged changes through the narrow diff surface implemented by the alpha.

`dits diff`

dits diff [OPTIONS] [FILE]

Options:
    --staged             Show staged changes
-c, --commit <COMMIT>    Resolve a commit before diffing
-h, --help               Show command help

Implemented modes

With no flag, Dits shows tracked modified or deleted working-tree paths against the current HEAD state.
--staged reports staged additions, modifications, deletions, renames, type changes, and mode changes.
The optional FILE is one exact repository-relative path, not a pathspec, directory expansion, or glob.
Working-tree text files receive a line diff. Binary files receive a changed marker and size information, not a semantic or chunk-region diff.

dits diff
dits diff README.md
dits diff --staged
dits diff --staged footage/scene.mov

--commit is not a historical comparison yet

The current implementation validates that the supplied commit resolves, then still renders the working tree against HEAD. It does not compare two commits or branches. Do not use it as evidence of a historical diff.

Unsupported Git-like syntax

Dits does not currently accept two commit operands, revision ranges, --cached, --stat, --name-only, --word-diff, --chunk-diff, or a --pathspec separator on this command. There is no difftool command or alias configuration surface.

Use history commands for commit inspection and file commands for status and staging. Exact syntax comes from dits diff --help.