Treeship
CLI reference

bundle

Create, export, and import .treeship bundle files.

treeship bundle create

Create a bundle from a list of artifacts.

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

Options

OptionDescription
--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.

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.

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

Bundles verify offline. No network, no Hub, no Treeship installation required beyond the verifier binary or WASM module.