skills/clean/SKILL.md
Clean up Kurtosis enclaves and artifacts. Remove stopped enclaves, running enclaves with -a flag, and stopped engine containers. Use when you need to free up resources or start fresh.
npx skillsauth add kurtosis-tech/kurtosis cleanInstall 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.
Remove Kurtosis enclaves and leftover artifacts.
Removes only stopped enclaves and stopped engine containers:
kurtosis clean
Removes all enclaves (including running ones):
kurtosis clean -a
To remove a specific enclave without touching others:
# Stop an enclave
kurtosis enclave stop <enclave-name>
# Remove a specific enclave
kurtosis enclave rm <enclave-name>
On Kubernetes, kurtosis clean -a can hang if the logs collector cleanup tries to create pods on tainted/unhealthy nodes. See the k8s-clean-cluster skill for manual cleanup steps.
On Docker, if clean hangs:
# Kill the hanging process
pkill -f "kurtosis clean"
# Manually remove containers
docker ps -a | grep kurtosis | awk '{print $1}' | xargs -r docker rm -f
# Remove networks
docker network ls | grep kurtosis | awk '{print $1}' | xargs -r docker network rm
# Restart engine
kurtosis engine start
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.