Argo CLI

What is Argo CLI?

The argo-cli image provides the command-line interface (CLI) for interacting with Argo Workflows, a Kubernetes-native workflow engine used to orchestrate complex jobs, data pipelines, and CI/CD workloads. The CLI enables users to submit workflows, monitor execution, and manage templates directly from the terminal.

This image is useful in CI pipelines, local development, or ephemeral containers that need to interact with an Argo controller running in a Kubernetes cluster. It is especially valuable for scripting, debugging, and automation tasks that involve submitting or managing Argo workflows from outside the cluster.

The argo-cli image is ideal for DevOps and platform teams building GitOps-style delivery pipelines or orchestrating ML/ETL jobs on Kubernetes.

How to use this image

The argo CLI interacts with the Argo Workflows controller via Kubernetes API and service accounts. It expects a valid kubeconfig or in-cluster credentials.

Run the CLI locally with your kubeconfig:

<code>docker run -it --rm \  -v $HOME/.kube/config:/kube/config \  -e KUBECONFIG=/kube/config \  quay.io/argoproj/argo-cli:latest version</code>

Submit a workflow manifest:

<code>docker run -v $(pwd):/work \  -v $HOME/.kube/config:/kube/config \  -e KUBECONFIG=/kube/config \  quay.io/argoproj/argo-cli:latest submit /work/workflow.yaml</code>

Other common CLI operations:

<code># List running workflowsargo list</code>

<code># Get logs for a workflow stepargo logs <workflow-name> -c main</code>

Logging and behavior:

‍All CLI output is printed to stdout. The container exits after the command completes unless used interactively (-it).

Image variants

Published under quay.io/argoproj/argo-cli, the image is versioned by release. There are no Alpine or OS-specific variants.

quay.io/argoproj/argo-cli:latest

Latest CLI release; may track pre-releases or minor updates.Use for dev environments or testing.

quay.io/argoproj/argo-cli:<version>

Tagged by Argo version (e.g. v3.5.7, v3.4.10).

Recommended for production to ensure compatibility with your Argo controller version.

Always match the CLI version to your Argo Workflows controller version for full feature and API compatibility.