skills/cluster-manage/SKILL.md
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.
npx skillsauth add kurtosis-tech/kurtosis cluster-manageInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Switch between Docker and Kubernetes backends for Kurtosis.
kurtosis cluster get
Returns docker or kubernetes.
kurtosis cluster ls
# 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
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
The cluster setting is stored in the Kurtosis config file:
kurtosis config path
Typically at ~/Library/Application Support/kurtosis/kurtosis-config.yml on macOS.
development
Develop and debug Kurtosis Starlark packages. Create packages from scratch, understand the plan-based execution model, use print() debugging, handle future references, and test packages locally. Use when writing or troubleshooting .star files.
data-ai
Manage services in Kurtosis enclaves. Add, inspect, stop, start, remove, update services. View logs, shell into containers, and execute commands. Use when you need to interact with running services.
content-media
Run Starlark scripts and packages with kurtosis run. Covers all flags including dry-run, args-file, parallel execution, image download modes, verbosity levels, and production mode. Use when executing Kurtosis packages locally or from GitHub.
testing
Manage Kurtosis Portal for remote context access. Start, stop, and check status of the Portal daemon that enables communication with remote Kurtosis servers. Use when working with remote Kurtosis contexts.