skills/context-manage/SKILL.md
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).
npx skillsauth add kurtosis-tech/kurtosis context-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.
Manage Kurtosis contexts for connecting to different Kurtosis instances.
Contexts define which Kurtosis instance the CLI talks to. The default context is default which connects to the local engine (Docker or Kubernetes).
kurtosis context ls
Shows all configured contexts and which one is active.
kurtosis context add <context-name>
kurtosis context set <context-name>
After switching, restart the engine or portal as needed.
kurtosis context rm <context-name>
# Check which context is active
kurtosis context ls
# Switch to a different environment
kurtosis context set staging
# Verify the switch succeeded
kurtosis context ls
# Start portal if using a remote context
kurtosis portal start
# Switch back to local
kurtosis context set default
| Scenario | Behavior | Resolution |
|----------|----------|------------|
| Switch to non-existent context | Command fails with error | Run kurtosis context ls to see available contexts |
| Remove active context | Command fails — cannot remove active | Switch to another context first with kurtosis context set |
| Engine running after switch | Engine still connected to old context | Run kurtosis engine restart after switching contexts |
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.