# download

## Usage

```bash
bdy artifact download|dd [options] <identifier> <directory>
```

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `identifier` | Human-readable ID of the artifact and optionally version: artifact@version (optional) |
| `directory` | Path to the directory or file (required) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `-p, --project <name>` | Project name. Can be set via variable: BUDDY_PROJECT |
| `-m, --merge` | Merge contents of the directory with artifact |
| `-r, --replace` | Replace contents of the directory with artifact |
| `-h, --help` | display help for command |

## Examples

### Download file artifact version to local directory

```bash
bdy art dd artifact-identifier@version /path/to/dir
```

### Download latest file artifact version and replace contents of existing local directory

```bash
bdy art dd artifact-identifier /path/to/dir --replace
```

### Download file artifact version and merge it with existing local directory

```bash
bdy art dd artifact-identifier@version /path/to/dir --merge
```


---
Original source: https://buddy.works/docs/cli/artifact/download