crab pull
Run git pull and optionally hydrate newly fetched Crab pointer files.
Synopsis
crab pull [OPTIONS]crab pull is the counterpart to crab ship
for receiving changes. It pulls from the selected Git remote and hydrates new
pointer files that match the repository's hydration filter.
Options
| Option | Default | Description |
|---|---|---|
--remote <REMOTE> | origin | Git remote to pull from |
--branch <BRANCH> | Current branch | Branch to pull |
--no-hydrate | Off | Skip automatic hydration after pulling |
--json | Off | Emit structured JSON output |
--jsonl | Off | Emit streaming JSONL output |
Examples
crab pull
crab pull --remote upstream --branch main
crab pull --no-hydrate --jsonUse crab hydrate afterward when you skip
automatic hydration.
The Git pull completes before Crab considers hydration. A merge or rebase
failure therefore stops the workflow before new pointer materialization. After
a successful pull, inspect git status and crab status to distinguish Git
integration state from file hydration state. --no-hydrate keeps new files as
pointers even if they match the configured hydration filter.
Use JSONL when a caller needs progress from both phases and JSON when it needs one terminal result. The selected remote and branch are Git names, not Crab storage URLs.