# bundle
Source: https://docs.treeship.dev/cli/bundle

> Create, export, and import .treeship bundle files.

## 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>