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

# Artifacts

> The 11 adside commands for Artifacts.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside artifacts --help` to see what your installed version has.

## artifacts

### artifacts create

Create an empty artifact and its refinement thread; save its first version next.

Beta: this command may still change.

```bash theme={null}
adside artifacts create --title <title> [flags]
```

| Flag | Value |
| - | - |
| `--title` (required) | `<title>` |
| `--origin-chat-thread-id` | `<id>` |
| `--listed` | `true\|false` |

### artifacts delete

Delete an artifact with its versions and its thread, and revoke its sharing link.

Beta: this command may still change.

```bash theme={null}
adside artifacts delete --artifact <artifact>
```

### artifacts duplicate

Copy an artifact's current version into a new artifact with its own thread, leaving the original alone.

Beta: this command may still change.

```bash theme={null}
adside artifacts duplicate --artifact <artifact> [flags]
```

| Flag | Value |
| - | - |
| `--artifact` (required) | `<artifact>` |
| `--title` | `<title>` |

### artifacts get

Read an artifact with its current version's files inline, ready to edit and send back with artifacts save, and where it was started.

Beta: this command may still change.

```bash theme={null}
adside artifacts get --artifact <artifact>
```

### artifacts list

List the workspace's artifacts: the documents, one-pagers and dashboards the agent has written, most recently changed first.

Beta: this command may still change.

```bash theme={null}
adside artifacts list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--offset` | `<0-100000>=0` | The next page, from the previous output. |

### artifacts prepare

Download a version's archive to edit it in place rather than writing the document again.

Beta: this command may still change.

```bash theme={null}
adside artifacts prepare --artifact <artifact> --version <version> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--artifact` (required) | `<artifact>` | |
| `--version` (required) | `<version>` | |
| `--dir` | `<dir>` | Unpack the version into this folder to edit it in place, instead of printing the archive |

### artifacts publish

Make a version the one a sharing link serves.

Beta: this command may still change.

```bash theme={null}
adside artifacts publish --artifact <artifact> [flags]
```

| Flag | Value |
| - | - |
| `--artifact` (required) | `<artifact>` |
| `--version` | `<min 1>` |

### artifacts restore

Bring an earlier version back: it is saved again as the newest version, marked as a restore of that one.

Beta: this command may still change.

```bash theme={null}
adside artifacts restore --artifact <artifact> --version <min 1>
```

### artifacts save

Save a new version: text files inline, images by the ID of an asset of this workspace.

Beta: this command may still change.

```bash theme={null}
adside artifacts save --artifact <artifact> --entry <entry> --summary <summary> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--artifact` (required) | `<artifact>` | |
| `--entry` (required) | `<entry>` | |
| `--files` | `'<json>'` | |
| `--summary` (required) | `<summary>` | |
| `--media` | `'<json>'` | |
| `--kit` | `v1` | |
| `--data-as-of` | `<data-as-of>` | |
| `--no-data` | `true\|false` | |
| `--thumbnail-asset-id` | `<id>` | |
| `--dir` | `<dir>` | Save this folder: text files inline, images uploaded to the library and named by id, the entry picked as index.html unless --entry says otherwise |

### artifacts update

Rename an artifact or show it in the Artifacts list (listed), without touching any of its versions.

Beta: this command may still change.

```bash theme={null}
adside artifacts update --artifact <artifact> [flags]
```

| Flag | Value |
| - | - |
| `--artifact` (required) | `<artifact>` |
| `--title` | `<title>` |
| `--listed` | `true\|false` |

### artifacts versions

List an artifact's saved versions, newest first.

Beta: this command may still change.

```bash theme={null}
adside artifacts versions --artifact <artifact>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.