Skip to content

ct list

List releases managed by ct apply from Kubernetes inventory ConfigMaps.

Terminal window
ct list --namespace production
ct list [flags]

ct list does not use positional arguments.

FlagShortTypeDefaultDescription
--namespace-nstringNamespace to search for release inventory
--all-namespaces-AboolfalseList releases from all namespaces
--contextstring(current)Kubeconfig context to use
--output-ostringtableOutput format: table, json, or yaml

List releases in a namespace:

Terminal window
ct list --namespace production

List releases across all namespaces:

Terminal window
ct list --all-namespaces

Print output as JSON:

Terminal window
ct list --all-namespaces --output json

Use a specific kube context and YAML output:

Terminal window
ct list -n staging --context staging --output yaml
ct list
├─ Create Kubernetes client (uses --context if provided)
├─ Search inventory ConfigMaps managed by ct
│ └─ Label selector: app.kubernetes.io/managed-by=ct
├─ Read release metadata from labels
├─ Count tracked resources from inventory data
└─ Print results as table, JSON, or YAML

By default, output is shown as a table with NAME, NAMESPACE, and RESOURCES.

  • ct apply — apply manifests and update release inventory
  • ct delete — delete releases using stored inventory