cluster-manage

Manage Kurtosis cluster settings. Switch between Docker and Kubernetes backends, list available clusters, and configure which cluster Kurtosis uses. Use when you need to change where Kurtosis runs enclaves.

Install

npx skills add https://github.com/kurtosis-tech/kurtosis --skill cluster-manage

SKILL.md

Cluster Manage

Switch between Docker and Kubernetes backends for Kurtosis.

Check current cluster

kurtosis cluster get

Returns docker or kubernetes.

List available clusters

kurtosis cluster ls

Switch cluster

# Switch to Docker
kurtosis cluster set docker

# Switch to Kubernetes (uses current kubectl context)
kurtosis cluster set kubernetes

After switching, restart the engine:

kurtosis engine restart

Kubernetes setup

When using Kubernetes:

Ensure kubectl is configured and can reach your cluster:
```
kubectl cluster-info
kubectl get nodes
```

Switch Kurtosis to Kubernetes:

kurtosis cluster set kubernetes
kurtosis engine start

Start the gateway (required for local CLI to reach the k8s-based engine):
```
kurtosis gateway &
```
Verify:
```
kurtosis engine status
```

Config file

The cluster setting is stored in the Kurtosis config file:

kurtosis config path

Typically at ~/Library/Application Support/kurtosis/kurtosis-config.yml on macOS.

Installs0

GitHub Stars540

LanguageGo

AddedMay 25, 2026