libra diff-index
Command reference for `libra diff-index`
Show the differences between a tree and the working tree — a plumbing entry
point that reuses the one diff engine (see diff).
Synopsis
libra diff-index <tree> [-- <path>...]Description
diff-index <tree> is equivalent to libra diff --old <tree>: it diffs the
given tree-ish against the current working tree. Path limiters go after --,
and all diff global flags apply.
--cached (compare the tree against the index) is not yet supported; use
libra diff --staged for HEAD vs the index.
Options
| Option | Description | Example |
|---|---|---|
<tree> | The tree-ish to compare against the working tree. | libra diff-index HEAD |
--cached / --cached | Compare against the index (not yet supported → exit 128). | |
-- <path>... | Limit the diff to paths. | libra diff-index HEAD -- src/ |
--json / --machine | Structured diff output. | libra --json diff-index HEAD |
Exit codes
| Code | Meaning |
|---|---|
0 | No differences. |
1 | There are differences (the diff is printed) — Git plumbing exit convention. |
128 | The tree could not be resolved, --cached was given (unsupported), or not inside a repository. |
Examples
# What has changed in the working tree relative to HEAD's tree?
libra diff-index HEAD
# HEAD vs the index (use diff --staged for now)
libra diff --stagedComparison with Git
| Task | Libra | Git |
|---|---|---|
| Tree vs working tree | libra diff-index <tree> | git diff-index <tree> |
| Tree vs index | libra diff --staged (HEAD only) | git diff-index --cached <tree> |
Deferred: --cached against an arbitrary tree, --stat-only raw output, and
-m. Use libra diff for richer options.