Virtual Filesystem
Mount Management
Use the mount-management commands when a FUSE mount is already running and you need to inspect, refresh, switch, or clean it.
Command Map
| Goal | Command |
|---|---|
| List active mounts | crab mount list |
| Get machine-readable mount list | crab mount list --json |
| Inspect one mount | crab mount status --mountpoint /mnt/models |
| Include dirty paths | crab mount status -m /mnt/models --verbose |
| Refresh from remote | crab mount refresh -m /mnt/models |
| Switch branch or ref | crab mount switch -m /mnt/models --ref main |
| Unmount one path | crab unmount -m /mnt/models |
| Unmount everything | crab unmount --all |
| Remove inactive caches | crab mount clean |
Typical Flows
Refresh a long-running mount
crab mount refresh --mountpoint /mnt/models
crab mount status --mountpoint /mnt/modelsCompare two refs
crab mount --repo ./repo --mountpoint /tmp/crab-view --ref main
crab mount switch --mountpoint /tmp/crab-view --ref experiment/v2
crab unmount --mountpoint /tmp/crab-viewClean inactive state
crab mount list
crab mount cleanUse crab mount clean --all only when no Crab mounts are active.
Troubleshooting
- If a mount looks stale, run
crab mount refreshand checkcrab mount status. - If unmount fails, close shells or programs whose current directory is inside the mountpoint, then retry.
- If local overlay changes are no longer needed, remount with
--clean-overlay. - Use
--jsononlistorstatusfor scripts and monitoring.
For full syntax, see the crab mount reference.