---
name: kubesphere/kubesphere-cluster-management
source: https://app.decimal.ai/s/kubesphere-kubesphere-cluster-management@1/SKILL.md
source_sha256: c0a870ee3791
---

# KubeSphere Cluster Query

> **⚠️ Security**: Read-only only. **Never** use kubectl to create, update, or delete cluster resources. Use KubeSphere console instead.

## When to Use

List or get KubeSphere cluster information: list clusters, get details, check status, identify host/member.

## Commands

```bash
# List clusters
kubectl get cluster

# Get cluster details
kubectl get cluster <name> -o yaml

# Get cluster summary (name, connection type, version, status)
kubectl get cluster -o go-template='
{{printf "%-12s %-12s %-12s %-15s %-13s %-12s\n" "NAME" "CONN_TYPE" "KS_VERSION" "K8S_VERSION" "ClusterReady" "KSCORE_READY"}}
{{range .items}}{{printf "%-12s %-12s %-12s %-15s" .metadata.name .spec.connection.type .status.kubeSphereVersion .status.kubernetesVersion}}{{range .status.conditions}}{{if eq .type "Ready"}}{{printf "%-13s" .status}}{{end}}{{end}}{{range .status.conditions}}{{if eq .type "KSCoreReady"}}{{printf "%-12s" .status}}{{end}}{{end}}{{"\n"}}{{end}}'
```

## Out of Scope

Cluster installation/upgrade/remove, any write operations. Use KubeSphere console.