Reference
This section contains the complete reference documentation for every Crab CLI command. Each page documents the command's synopsis, arguments, options, behavior, and structured output format.
For conceptual explanations of how these commands fit together, see the topic-oriented sections in the sidebar (Getting Started, Working with Files, Storage Management, etc.).
| Command | Description |
|---|
crab add | Stage files for chunking and deduplication |
crab push | Upload staged chunks and refs to cloud storage |
crab fetch | Download remote changes from cloud storage |
crab hydrate | Materialize pointer files into full content |
crab dehydrate | Replace hydrated files with pointer blobs |
crab reset | Unstage files from the Crab staging area |
crab lock | Lock files to prevent concurrent edits |
crab diff | Show content differences between file versions |
| Command | Description |
|---|
crab init | Initialize a new Crab repository |
crab clone | Clone a Crab repository from cloud storage |
crab track | Configure file patterns for Crab to manage |
crab import | Import existing cloud buckets as a repository |
| Command | Description |
|---|
crab cache | Manage the local chunk cache |
crab staging | Inspect and manage the local staging area |
crab gc | Remove unreachable objects from storage |
crab prune | Evict local cache objects |
crab repack | Consolidate remote Git pack files |
crab compact | Compact metadata and storage layers |
crab tier | Manage storage tier assignments |
crab optimize | Optimize xorbs, packs, shards, tiers, caches, indexes, LFS, workflow cache, replicas, and repo cost posture |
| Command | Description |
|---|
crab mount | Mount a repository as a virtual filesystem |
crab daemon | Run persistent named multi-repo mounts |
crab lfs | Manage Git LFS compatibility layer |
| Command | Description |
|---|
crab run | Execute a command with content-addressed caching |
crab workflow | Define and run multi-step pipelines |
crab exp | Create and manage experiment runs |