> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trycassian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cassian sync

> Pull files from the instance to local.

## Usage

```bash theme={null}
cassian sync [options]
```

Downloads files from the container to your local directory. Respects your workspace policies: `no_sync`, `storage`, and `exclude` paths are skipped.

## Options

| Flag              | Description                       |
| ----------------- | --------------------------------- |
| `--path <subdir>` | Only pull a specific subdirectory |

## Pull a subdirectory

```bash theme={null}
cassian sync --path checkpoints/
cassian sync --path results/run_42/
```

Instead of pulling the entire workspace, pull just the folder you care about. The path is relative to `/workspace`.

## When to use

* Grab model checkpoints after a training run
* Pull results or evaluation outputs
* One-shot sync without opening a terminal
* Recover files after a session ends

## What gets pulled

Everything in `/workspace` except paths under `no_sync`, `storage`, and `exclude` in your `cassian.yaml`.

`no_sync` folders live on the instance and in cloud storage but are intentionally not synced to local — `cassian sync` respects this. If you need a `no_sync` folder locally, copy it manually during a `cassian ssh` session.