agentstack bundle

Synopsis

agentstack bundle export --profile-file <path> --output <path> [--include-assets]

Description

The bundle command creates a deterministic, portable archive of your profile. The bundle includes the canonical agentstack.yaml and translated configs for all enabled providers. Secret values are never included — only secret name references appear in the bundle.

Bundles are safe to share publicly or with your team.

Subcommands

export

Export a profile to a bundle file.

Flag	Type	Required	Description
--profile-file <path>	string	Yes	Path to the canonical agentstack.yaml
--output <path>	string	Yes	Output path for the bundle archive
--include-assets	boolean	No	Include referenced local asset files (e.g., skill Markdown files)

Examples

Export a profile to a bundle:

Export bundle

agentstack bundle export \
  --profile-file ~/.agentstack/profiles/main/agentstack.yaml \
  --output ./my-profile.bundle.zip

Export with local skill files included:

Export with assets

agentstack bundle export \
  --profile-file ~/.agentstack/profiles/main/agentstack.yaml \
  --output ./my-profile.bundle.zip \
  --include-assets

Notes

Note

Bundles never contain secret values. Required env names and other non-secret references are preserved, but each machine must still set its own local secret values via agentstack secrets set.

Tip

Use bundles for one-time sharing. For ongoing sync across machines, use agentstack sync instead.