gat ls-files

List paths from the current gat.lock, including files missing from disk. Filters match tracked paths without walking the filesystem. Use Path selection to preview a working set, or gat status to compare the working lock with the staged lock.

Output includes headings, counts, and hints. Rows and long paths are limited by default; use gat ls-files --full-output for all rows and complete paths. This remains a human report, not a plain path stream for scripts.

Without path flags, use the default named selection, or all paths if none is set. Explicit filters replace that selection; --path . selects the whole repository.

Path selection rules

Selector	Selection used
`--selection NAME`	One saved definition, without changing the default.
`--path`, `--include`, or `--exclude`	.

Named and inline selectors cannot be combined. Paths are relative to the repository root; patterns are relative to the selected path. See Path selection and gat selection.

Usage

Usage: gat ls-files [OPTIONS]

All options

Usage: gat ls-files [OPTIONS]

Options:
  -o, --full-output
          Show all rows and complete details

      --selection <NAME>
          Use this saved selection for this operation without changing the
          default

      --path <PATH>
          Select this file or subtree. Any explicit --path, --include, or
          --exclude replaces the complete configured selection. Use --path . for
          the whole repository. For mount add, omission selects the source root;
          repository selection defaults never apply to mounts

      --include <INCLUDE>
          Glob pattern (matched relative to `--path`) selecting which paths to
          include. Repeatable. Component-aware: `*.bin` matches only immediate
          children, while `**/*.bin` matches recursively. Empty means everything
          under `--path`

      --exclude <EXCLUDE>
          Glob pattern (matched relative to `--path`) excluded from `--include`
          (or from everything under `--path`, if `--include` is empty).
          Repeatable. Component-aware like `--include`; exclude always wins over
          include

  -h, --help
          Print help (see a summary with '-h')

Examples

Default selection
Directory
Glob pattern
All paths

List paths in the current selection.

gat ls-files

List one tracked subtree.

gat ls-files --path data/

List matching tracked paths.

gat ls-files --include '**/*.onnx'

Replace the complete configured selection with an explicit repository-root selection.

gat ls-files --path .

Getting Started

Concepts

Guides

References

Commands

gat ls-files

Usage

Examples

​Usage

​Examples

Usage

Examples