Reference
crab lock
Lock files to prevent concurrent edits.
Synopsis
crab lock [OPTIONS] <PATH>
crab unlock <PATH>
crab lock --listDescription
crab lock acquires a distributed lock on a file, preventing other users from
pushing changes to it. This is essential for binary files (3D models, compiled
assets) where git's merge strategy would produce garbage.
Locks are stored in the remote object store alongside your data, making them visible to all collaborators.
For conceptual background, see File Locking.
Arguments
| Argument | Required | Description |
|---|---|---|
PATH | Yes (for lock/unlock) | Path to the file to lock or unlock |
Options
| Option | Default | Description |
|---|---|---|
--list | false | List all currently held locks |
--force | false | Force-break a lock held by another user |
--json | false | Emit structured JSON output |
Examples
Lock a file
crab lock models/character.fbxUnlock a file
crab unlock models/character.fbxList all locks
crab lock --listForce-break a stale lock
crab lock --force models/character.fbxRelated Commands
crab push— push respects locks.crab status— shows locked files.