libra ls-files

List tracked index entries and untracked working-tree paths.

Synopsis

libra ls-files [OPTIONS] [pathspec]...

Description

libra ls-files reads Libra's index and working tree and prints repository paths without mutating refs, the index, the worktree, or object storage. With no state filter it defaults to the cached index view, so tracked paths remain listed even when the working tree copy is modified or deleted.

This public compatibility slice supports cached listing, modified/deleted filters, stage-style output, untracked listing, .libraignore-aware filtering via --others --exclude-standard, ignored-only listing via -i/--ignored (-i -o for ignored untracked files, -i -c for tracked files matching an exclude pattern), repository-local pathspec filtering, --error-unmatch, NUL-delimited text output via -z, status tags via -t, and unmerged-only listing via -u / --unmerged. --full-name is accepted as a no-op (Libra always prints repo-root-relative paths).

Pathspecs are resolved from the caller's current working directory, not forced to the repository root. Exact-file and directory-prefix filtering are both supported; pathspecs that resolve outside the repository are rejected. The resolve-undo and sparse-checkout integration remain deferred.

Options

Examples

libra ls-files
libra ls-files --modified
libra ls-files --deleted
libra ls-files --others
libra ls-files --others --exclude-standard
libra ls-files -o -x '*.log'              # untracked files except *.log
libra ls-files -o -X .extra-excludes      # read extra exclude patterns from a file
libra ls-files -i -o --exclude-standard   # only the ignored untracked files
libra ls-files tracked-dir
libra ls-files --others --exclude-standard others-dir
libra ls-files --error-unmatch src/lib.rs
libra ls-files -z tracked-dir
libra ls-files --stage
libra ls-files -t
libra ls-files -t --others --exclude-standard
libra ls-files -u
libra --json ls-files --modified

Human Output

Default output prints one repository path per line:

.libraignore
tracked.txt

--stage and -s print Git-style stage records:

100644 4f3c2d1a7b8c9d0e1234567890abcdef12345678 0	tracked.txt

-z keeps the same record shape but terminates each record with NUL instead of newline, which is useful for shell-safe scripting:

tracked-dir/alpha.txt\0tracked-dir/bravo.txt\0

Structured Output

--json and --machine use the standard Libra command envelope. Each entry in data includes path, hash, mode, stage, and status. Untracked entries use null for fields that do not apply:

{
  "ok": true,
  "command": "ls-files",
  "data": [
    {
      "path": "tracked.txt",
      "hash": "4f3c2d1a7b8c9d0e1234567890abcdef12345678",
      "mode": "100644",
      "stage": 0,
      "status": "modified"
    },
    {
      "path": "untracked.txt",
      "hash": null,
      "mode": null,
      "stage": null,
      "status": "other"
    }
  ]
}

Parameter Comparison: Libra vs Git vs Jujutsu