Reference
crab fetch
Download remote refs and pre-warm the local chunk cache.
Synopsis
crab fetch [OPTIONS] [<REMOTE>] [<REFSPECS>...]Description
crab fetch downloads refs and optionally pre-fetches chunk data from the
remote object store into the local cache. This is useful for warming the cache
before hydration, reducing latency when you later run crab hydrate.
When used without additional options, it behaves like git fetch for the
crab remote — updating local tracking refs. With --prefetch, it also
downloads xorb data for pointer blobs reachable from the fetched refs.
For conceptual background, see Fetching Updates.
Arguments
| Argument | Required | Description |
|---|---|---|
remote | No | Remote name or URL. Defaults to origin. |
refspecs | No | Refspecs to fetch. Defaults to the configured fetch refspec. |
Options
| Option | Short | Default | Description |
|---|---|---|---|
--prefetch | false | Pre-download chunk data into local cache | |
--jobs | -j | 8 | Concurrent download workers |
--json | false | Emit structured JSON output | |
--jsonl | false | Stream JSONL progress events |
Examples
Fetch refs from origin
crab fetchFetch and pre-warm cache
crab fetch --prefetchFetch from a specific remote
crab fetch my-remoteRelated Commands
crab hydrate— materialize files after fetching.crab push— upload to remote.crab clone— initial clone from remote.