Reference
crab prune
Evict local cache objects.
Synopsis
crab prune [OPTIONS]Description
crab prune runs local LRU eviction for current cache objects: chunks, xorbs,
and shards. This frees disk space without affecting the remote store — pruned
data can be fetched again when needed.
For conceptual background, see Pruning Objects.
Options
| Option | Default | Description |
|---|---|---|
--dry-run | false | Show what would be pruned without deleting |
--verbose | false | Print each pruned cache object |
--json | false | Emit one structured JSON result |
--jsonl | false | Emit streaming JSONL events |
Examples
crab prune --dry-run
crab pruneAlways inspect --dry-run before eviction when cache warmth matters. The real
operation removes local cache objects until configured budgets are satisfied;
referenced remote data remains intact and can be fetched again. A later read may
therefore incur network transfer and reconstruction time. Use JSONL to record
individual progress events or JSON when automation needs one terminal result.
Related commands
crab gc: remove unreachable remote objects.crab cache: manage the chunk cache.