CLI
The ark command-line tool lets you run, validate, and manage ArkTeam pipelines — locally without a cluster, or against a live Kubernetes deployment.
Install
go install (recommended)
Requires Go 1.26 or later.
go install github.com/arkonis-dev/ark-operator/cmd/ark@latest
Verify:
ark --version
# ark v0.9.0 (go1.26)
Binary download
Pre-built binaries for Linux, macOS, and Windows are attached to each GitHub release:
# macOS (Apple Silicon)
curl -L https://github.com/arkonis-dev/ark-operator/releases/latest/download/ark-darwin-arm64 \
-o ark && chmod +x ark && sudo mv ark /usr/local/bin/ark
# macOS (Intel)
curl -L https://github.com/arkonis-dev/ark-operator/releases/latest/download/ark-darwin-amd64 \
-o ark && chmod +x ark && sudo mv ark /usr/local/bin/ark
# Linux (amd64)
curl -L https://github.com/arkonis-dev/ark-operator/releases/latest/download/ark-linux-amd64 \
-o ark && chmod +x ark && sudo mv ark /usr/local/bin/ark
# Linux (arm64)
curl -L https://github.com/arkonis-dev/ark-operator/releases/latest/download/ark-linux-arm64 \
-o ark && chmod +x ark && sudo mv ark /usr/local/bin/ark
Windows: download ark-windows-amd64.exe from the releases page, rename to ark.exe, and add to PATH.
Commands
| Command | Description |
|---|---|
ark run | Execute an ArkTeam pipeline locally |
ark deploy | Apply resources to a cluster in dependency order |
ark trigger | Trigger a team run in a live cluster |
ark validate | Validate DAG structure without executing |
ark trace | Look up a task trace in Jaeger or Tempo |
ark status | Show operator and team status in a cluster |
ark logs | Tail logs from agent pods |
Notes
ark run supports pipeline mode (spec.pipeline set). Dynamic delegation mode requires a live cluster with agent pods and Redis queues.
The ark CLI shares the same YAML format as the operator. Teams developed locally deploy to Kubernetes unchanged.