Getting Started — chart-test-swarm

Prerequisites

The following tools must be installed before you begin:

✓ Kubernetes (kind/k3d)

✗ Kubernetes (kind/k3d) brew install k3d

✓ kubectl

✓ helm

✓ yq

✓ jq

✓ uv

Cluster Status

● Not running

No chart-test-swarm kind cluster detected. Run Step 2 to create one.

Fastest Path: One Command

Want to jump straight in? The /helm-swarm-test Droid skill wraps chart-test-swarm test into a single command that verifies prerequisites, spins up the cluster, runs the full support matrix, auto-fixes failures, and updates the dashboard — all in one shot.

Run the agentic full-matrix test loop:

chart-test-swarm test

Use /helm-swarm-test for interactive mode or chart-test-swarm test for headless/CI. See chart-test-swarm test --help for all options including --no-fix, --suite, and --keep-cluster.

Workflow

Follow these steps to test your Helm chart:

1 Verify Prerequisites

Check that all required tools are installed and working.

make verify

2 Create Cluster

Spin up a local kind cluster with all dependencies.

make up

3 Run Scenarios

Execute test scenarios against your chart.

chart-test-swarm run --suite curated-live

Or run all scenarios:

chart-test-swarm run --all

4 View Results

See the results of your test runs in the dashboard.

Open Runs Page →

5 Fix Failures

Review recommendations and apply fixes to your chart.

Open Recommendations →

6 Tear Down

Clean up the cluster when you're done testing.

make down