菜单
Manage the Kurtosis engine server. Start, stop, restart the engine, check status, and view engine logs. Covers both Docker and Kubernetes engine backends. Use when the engine won't start, needs restarting, or you need to check engine health.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build and test the Kurtosis CLI from source. Compile the CLI binary locally, run it against Docker or Kubernetes engines, and iterate on CLI changes without creating a release. Use when developing or debugging CLI commands.
Manage Kurtosis contexts for connecting to different Kurtosis instances. Add, list, switch, and remove contexts. Use when working with multiple Kurtosis environments (local, remote, team shared).
Inspect and manage Kurtosis enclaves. List enclaves, view services and ports, examine file artifacts, dump enclave state for debugging, and clean up. Use when you need to understand what's running inside an enclave or export its state.
Inspect, download, upload, and debug Kurtosis file artifacts. View artifacts in an enclave, download them locally for inspection, upload local files, and troubleshoot file mounting issues. Use when services can't find expected files or configs are wrong.
Lint and format Kurtosis Starlark files. Check syntax, validate docstrings, and auto-format .star files. Use when writing or reviewing Starlark packages to ensure code quality.
View and manage port mappings for Kurtosis services. Check which local ports map to service ports and troubleshoot connectivity. Use when services aren't reachable or you need to find the right port.
| name | engine-manage |
| description | Manage the Kurtosis engine server. Start, stop, restart the engine, check status, and view engine logs. Covers both Docker and Kubernetes engine backends. Use when the engine won't start, needs restarting, or you need to check engine health. |
| compatibility | Requires kurtosis CLI. Docker or Kubernetes cluster access depending on backend. |
| metadata | {"author":"ethpandaops","version":"1.0"} |
Manage the Kurtosis engine server lifecycle.
kurtosis engine status
Shows whether the engine is running and its version.
# Start with default settings
kurtosis engine start
# Start with debug images
kurtosis --debug-mode engine start
On Kubernetes, the engine runs as a pod in a kurtosis-engine-* namespace. You also need to run kurtosis gateway to access it from your local machine.
kurtosis engine stop
kurtosis engine restart
Equivalent to stop + start. Useful after changing cluster settings or upgrading.
kurtosis engine logs
Dumps engine server logs. Useful for diagnosing startup failures or API errors.
# Check which backend is active
kurtosis cluster get
# Switch to Docker
kurtosis cluster set docker
kurtosis engine restart
# Switch to Kubernetes
kurtosis cluster set kubernetes
kurtosis engine restart
kurtosis gateway # Required for k8s
When running on Kubernetes:
# The engine runs in its own namespace
kubectl get ns | grep kurtosis-engine
# Check engine pod
kubectl get pods -n <engine-namespace>
# View engine logs directly
kubectl logs <engine-pod> -n <engine-namespace>
# Start the gateway (required for local CLI to reach k8s engine)
kurtosis gateway &
| Symptom | Fix |
|---|---|
No Kurtosis engine is running | Run kurtosis engine start |
Engine starts but engine status shows nothing (k8s) | Start the gateway: kurtosis gateway |
| Version mismatch warning | kurtosis engine restart to match CLI version |
| Engine start hangs (k8s) | Check pods: kubectl get pods -A | grep kurtosis |
| Old engine blocking new start | kurtosis engine stop then clean namespaces |