CLI Overview

stax is the reference CLI for building, validating, inspecting, materializing, and publishing stax artifacts.

The CLI is both a user tool and a conformance reference for the specification.

Think Docker, but for agents

The stax CLI follows the same mental model as Docker:

stax build is the agent equivalent of docker build
stax push is the agent equivalent of docker push
stax pull is the agent equivalent of docker pull

Consumers may then materialize or import the pulled artifact into a specific runtime or platform.

Command Reference

Authoring

stax init

Scaffold a new agent or package project

stax build

Compile definitions and produce OCI layers

stax build-source

Build cacheable workspace source artifacts

stax validate

Validate definitions without producing artifacts

Distribution

stax push

Push built artifact to OCI registry

stax pull

Pull artifact from registry

stax login

Authenticate with OCI registry

Consumption

stax materialize

Resolve and translate to runtime-native files

stax plan-install

Generate machine-readable install plan

stax inspect

Display artifact metadata and layers

stax extract

Extract canonical layers for debugging

Verification

stax diff

Compare two artifacts or projects

stax verify

Verify signatures or attestations