ksail cluster list

List all Kubernetes clusters managed by KSail.

By default, lists clusters from all distributions across all providers.
Use --provider to filter results to a specific provider.

Output Format:
  PROVIDER   DISTRIBUTION   CLUSTER       STATUS
  docker     Vanilla        dev-cluster   Running
  docker     K3s            test-cluster  Stopped
  hetzner    Talos          prod-cluster  Unknown

The STATUS column reports the cluster's run-state: "Running" when its nodes are
up, "Stopped" when they exist but are not running (e.g. a stopped Docker
cluster), and "Unknown" for providers that cannot report it (cloud providers).
Kubeconfig contexts KSail did not provision are also listed with STATUS
"Unmanaged" (blank PROVIDER/DISTRIBUTION) so they are visible on the CLI just as
in the web UI; KSail-only operations (delete/stop/update) do not act on them.

When any cluster has a TTL set, a TTL column is appended:
  PROVIDER   DISTRIBUTION   CLUSTER       STATUS    TTL
  docker     K3s            dev-cluster   Running   2h 30m

The PROVIDER and CLUSTER values from the output can be used directly
with other cluster commands:
  ksail cluster delete --name <cluster> --provider <provider>
  ksail cluster stop --name <cluster> --provider <provider>

Use --output json for machine-readable output. The JSON is an array of objects:
  [
    {"name": "dev", "provider": "docker", "distribution": "Vanilla", "status": "Running", "ttl": "2h 30m"}
  ]
The "status" field is "Running", "Stopped", "Unknown", or "Unmanaged" (see the STATUS column).
The "ttl" field is null when no TTL is set and "EXPIRED" once the TTL has elapsed.

Examples:
  # List all clusters
  ksail cluster list

  # List only Docker-based clusters
  ksail cluster list --provider Docker

  # List only Hetzner clusters
  ksail cluster list --provider Hetzner

  # List only Omni clusters
  ksail cluster list --provider Omni

  # Machine-readable JSON (name/provider/distribution/ttl)
  ksail cluster list --output json

Usage:
  ksail cluster list [flags]

Flags:
      --output string       Output format: text or json. Use json for machine-readable structured output (array of {name, provider, distribution, status, ttl}). (default "text")
  -p, --provider Provider   Filter by provider (Docker, Hetzner, Omni, AWS, GCP, Azure, Kubernetes). If not specified, lists all providers.

Global Flags:
      --benchmark       Show per-activity benchmark output
      --config string   Path to config file (default: ksail.yaml found via directory traversal)
      --experimental    Enable experimental (unstable) commands and features