multiAI Summary Pending

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.

528 stars

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/cluster-manage/SKILL.md --create-dirs "https://raw.githubusercontent.com/kurtosis-tech/kurtosis/main/skills/cluster-manage/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/cluster-manage/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How cluster-manage Compares

Feature / Agentcluster-manageStandard Approach
Platform SupportmultiLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Which AI agents support this skill?

This skill is compatible with multi.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Cluster Manage

Switch between Docker and Kubernetes backends for Kurtosis.

## Check current cluster

```bash
kurtosis cluster get
```

Returns `docker` or `kubernetes`.

## List available clusters

```bash
kurtosis cluster ls
```

## Switch cluster

```bash
# Switch to Docker
kurtosis cluster set docker

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

After switching, restart the engine:

```bash
kurtosis engine restart
```

## Kubernetes setup

When using Kubernetes:

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

2. Switch Kurtosis to Kubernetes:
   ```bash
   kurtosis cluster set kubernetes
   kurtosis engine start
   ```

3. Start the gateway (required for local CLI to reach the k8s-based engine):
   ```bash
   kurtosis gateway &
   ```

4. Verify:
   ```bash
   kurtosis engine status
   ```

## Config file

The cluster setting is stored in the Kurtosis config file:

```bash
kurtosis config path
```

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