Reference
crab ls-files
List files tracked by Crab.
Synopsis
crab ls-files [OPTIONS]Description
crab ls-files lists files managed by Crab's filter driver and reports their
hydration state. It currently lists the repository-wide set; use the display
options to control which fields are shown.
Options
| Option | Default | Description |
|---|---|---|
-l, --long | false | Show full 64-character hashes |
-s, --size | false | Include file sizes |
-n, --name-only | false | Show only file names |
-j, --json | false | Emit machine-readable JSON output |
-d, --debug | false | Show all available fields for debugging |
Examples
List all tracked files
crab ls-filesList with hashes and sizes
crab ls-files --long --sizeShow only names
crab ls-files --name-onlyUse --name-only as input to path-oriented shell tools, and use --json when
another program needs hashes, sizes, or hydration state. --debug exposes all
available fields and is intended for diagnosis rather than a stable display
contract. The command is read-only: it reports the repository-wide tracked set
without hydrating files or changing tracking patterns.
Related commands
crab status: inspect hydration state.crab track: manage tracking patterns.crab du: report storage usage.