UDS CLI

UDS CLI is the command-line DevX for working with the UDS ecosystem. It is the primary way to run UDS workflows from a terminal, including bundle authoring, artifact creation, deployment, publishing, cluster operations, and task automation.

Key Commands

Command	Description
`uds create`	Build a UDS Bundle from a `uds-bundle.yaml`
`uds deploy`	Deploy a bundle from a local file or OCI registry
`uds inspect`	Inspect bundle metadata, images, SBOMs, and variables
`uds publish`	Publish a bundle to an OCI registry
`uds remove`	Remove a deployed bundle from a cluster
`uds run`	Execute tasks from a `tasks.yaml` via UDS Runner
`uds monitor pepr`	Stream Pepr admission and operator logs
`uds zarf`	Access the vendored Zarf CLI

Full command reference is available via uds --help and uds <command> --help.

Getting StartedInstall UDS CLI and deploy your first bundle.

How-to GuidesCommon operational patterns.

UDS CLI Next ModeWhy Next mode exists, what it currently supports, and how Next bundles work.

Schema Validation & IDE Setup

UDS CLI ships with a JSON schema for uds-bundle.yaml. To enable IDE autocompletion and validation, see the schema validation docs.

Ecosystem Context

UDS CLI works alongside UDS Core, the platform layer providing networking, identity, security, and observability. To understand how bundles fit into the broader UDS ecosystem, see:

Get Involved

UDS CLI on GitHub