Reference
crab migrate
Inspect large-file history and convert DVC workflow state into Crab metadata.
The history-rewrite commands are currently dry-run only: non-dry-run requests
fail explicitly without changing the repository. Use crab adopt for the
supported working-tree cutover path.
Synopsis
crab migrate <SUBCOMMAND> [OPTIONS]Subcommands
| Command | Purpose |
|---|---|
crab migrate info | Report file types above a size threshold that would benefit from tracking |
crab migrate import | Preview a large-file-to-pointer history migration; applying it is not yet supported |
crab migrate export | Preview a pointer-to-full-file history migration; applying it is not yet supported |
crab migrate from-dvc | Convert a dvc.yaml pipeline to crab.yaml |
Examples
Inspect large-file extensions:
crab migrate info
crab migrate info --above 10485760 --top 5Preview a prospective history rewrite:
crab migrate import --include '*.bin' --include '*.safetensors' --dry-run
crab migrate import --include '*.bin' --everything --dry-runPreview exporting selected pointer-backed files from history:
crab migrate export --include '*.bin' --dry-runConvert a DVC pipeline:
crab migrate from-dvc --dir . --output crab.yamlUse --stdout with from-dvc to inspect the converted YAML without writing a
file.