---
title: bundle
description: Create, export, and import .treeship bundle files.
---

import { Callout } from 'fumadocs-ui/components/callout';

## treeship bundle create

Create a bundle from a list of artifacts.

```bash
treeship bundle create --artifacts art_a1b2,art_c3d4 --tag v1.0
```

### Options

| Option | Description |
|--------|-------------|
| `--artifacts <ids>` | Comma-separated artifact IDs to include (required) |
| `--tag <tag>` | Human-readable tag for this bundle |
| `--description <text>` | Description of what this bundle contains |

## treeship bundle export

Export a bundle to a portable .treeship file.

```bash
treeship bundle export art_f7e6d5c4 --out chain.treeship
```

The bundle contains every artifact in the chain, all signatures, and the public key. It is self-verifying.

## treeship bundle import

Import a .treeship file into your local artifact store.

```bash
treeship bundle import chain.treeship
```

```
✓ imported 4 artifacts from chain.treeship
  chain integrity: verified
```

## Bundle format

A `.treeship` file is a signed, self-contained archive:

```
bundle.treeship
├── manifest.json      # Artifact list, chain order, metadata
├── artifacts/         # All DSSE envelopes
├── public_key.pem     # Ship's public key
└── signature          # Ed25519 signature over manifest
```

<Callout type="info">
Bundles verify offline. No network, no Hub, no Treeship installation required beyond the verifier binary or WASM module.
</Callout>
