Reference
crab status
Report hydration state of tracked files.
Synopsis
crab status [OPTIONS] [PATTERNS]...Description
crab status shows the current state of Crab-tracked files in the working
tree: which files are hydrated (full content), which are dehydrated (pointer
blobs), and which have modifications.
For conceptual background on file states, see Working with Files.
Arguments
| Argument | Required | Description |
|---|---|---|
PATTERNS | No | Glob patterns to filter. Defaults to all tracked files. |
Options
| Option | Short | Default | Description |
|---|---|---|---|
--porcelain | false | Machine-readable output (one file per line) | |
--json | false | Emit structured JSON output | |
--jsonl | false | Stream JSONL output |
Examples
Show all tracked file states
crab statusFilter by pattern
crab status '*.safetensors'Machine-readable output
crab status --porcelainOutput
Tracked files (5 total):
H models/weights.bin 1.2 GB (hydrated)
H models/embeddings.bin 800 MB (hydrated)
P data/eval.safetensors 300 MB (pointer)
P data/test.safetensors 150 MB (pointer)
M config/vocab.bin 2.1 MB (modified)State indicators:
H— Hydrated (full content on disk)P— Pointer (dehydrated, content in cloud)M— Modified (hydrated with uncommitted changes)
Related Commands
crab hydrate— materialize pointer files.crab dehydrate— replace files with pointers.crab ls-files— list all tracked files.crab du— disk usage breakdown.