Skip to main content
Build enqueues a package build, polls it to a terminal status, and prints the receipt.

Arguments and options

default:"active draft"
The agent to build, as a handle, UUID, or FQN. Omit it to build the agent in your current context.
The package version to build, such as 0.2.0. Omit to let the platform assign the next version.
default:"--wait"
Wait for the build to reach a terminal status. On by default. --no-wait returns as soon as the build is enqueued.
Output the build receipt as JSON.

What a build produces

An immutable package pinned to a version. Nothing about it changes afterward — a fix means a new version, which is what gives every deployment and every run exact provenance. To draft or change the spec first, use jstm agent plan. Build compiles what has already been committed.

Building as part of promotion

The stage commands accept --build so you can build and stage in one step:
See Stages.

After building

See also