LibraLibra
LibraLibra
DocsBlogLibra
Getting Started
Architecture
Design
Commands
libra addlibra agentlibra alternateslibra applylibra archivelibra authlibra automationlibra bisectlibra blamelibra branchlibra bundlelibra cachelibra cat-filelibra check-attrlibra check-ignorelibra check-mailmaplibra checkoutlibra cherry-picklibra cleanlibra clonelibra cloudlibra code-controllibra codelibra commit-treelibra commitlibra completionslibra configlibra credentiallibra depslibra describelibra diff-fileslibra diff-indexlibra diff-treelibra difflibra dirtylibra fast-exportlibra fast-importlibra fetchlibra filelibra for-each-reflibra format-patchlibra fscklibra gclibra graphlibra greplibra hash-objectlibra hookslibra hydratelibra index-packlibra initlibra investigatelibra layerlibra lfslibra loglibra logfilelibra loginlibra logoutlibra ls-fileslibra ls-remotelibra ls-treelibra maintenancelibra medialibra merge-baselibra merge-filelibra mergelibra metadatalibra mvlibra noteslibra oplibra openlibra pack-objectslibra packagelibra prunelibra publishlibra pulllibra pushlibra read-treelibra rebaselibra refloglibra remotelibra repacklibra replacelibra rererelibra resetlibra restorelibra rev-listlibra rev-parselibra revertlibra reviewlibra revisionlibra rmlibra sandboxlibra servicelibra shortloglibra show-reflibra showlibra sparse-viewlibra stashlibra statslibra statuslibra switchlibra symbolic-reflibra taglibra update-indexlibra update-reflibra usagelibra verify-packlibra whoamilibra worktreelibra write-tree
API Reference
Policy
Commands

libra diff-files

Command reference for `libra diff-files`

Show the differences between the index and the working tree — a plumbing entry point that reuses the one diff engine (see diff).

Synopsis

libra diff-files [-- <path>...]

Description

diff-files is equivalent to a bare libra diff: it shows the unstaged changes (index vs working tree). Path limiters go after --, and all diff global flags (--json, --stat, -M, …) apply.

Options

OptionDescriptionExample
-- <path>...Limit the diff to paths.libra diff-files -- src/
--json / --machineStructured diff output.libra --json diff-files

Exit codes

CodeMeaning
0No differences.
1There are differences (the diff is printed) — Git plumbing exit convention.
128Not inside a repository.

Examples

# Show unstaged changes
libra diff-files

# Limit to a directory
libra diff-files -- src/

Comparison with Git

TaskLibraGit
Unstaged changeslibra diff-filesgit diff-files

Deferred: -1/-2/-3 stage selection and raw output. Use libra diff for richer options.

libra describe

Command reference for `libra describe`

libra diff-index

Command reference for `libra diff-index`

On this page

SynopsisDescriptionOptionsExit codesExamplesComparison with Git