CLI Reference
catty sync
Downloads a workspace snapshot and extracts it to your current directory, overwriting existing files.
Synopsis
catty sync <label> [options]Arguments
| Argument | Description |
|---|---|
label | Session label (e.g., brave-tiger-1234) |
Options
| Option | Description |
|---|---|
--dry-run | Show what would be synced without making changes |
Examples
# Preview what would be synced
catty sync brave-tiger-1234 --dry-run
# Sync to current directory
catty sync brave-tiger-1234Difference from Download
| Command | Behavior |
|---|---|
catty download | Creates a new directory with the workspace |
catty sync | Overwrites files in current directory |
Use download for backups. Use sync to update your working directory.
catty sync overwrites local files with remote versions. Always use --dry-run first to preview changes.
When to Use
- Pull changes made while you were disconnected
- Recover files if sync-back was disabled
- Update local directory after reconnecting from different location
See Also
- catty download - Download to new directory
- catty connect - Reconnect with live sync-back
- Sync-Back - Real-time sync during session