skills/portal/SKILL.md
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.
npx skillsauth add kurtosis-tech/kurtosis portalInstall 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 the Kurtosis Portal daemon for remote context access.
Kurtosis Portal is a lightweight local daemon that enables communication with Kurtosis enclaves running on a remote Kurtosis server. It's only needed when using remote contexts — not required for local Docker or direct Kubernetes access.
kurtosis portal start
kurtosis portal status
kurtosis portal stop
Portal is used with remote Kurtosis contexts. If you're using:
kurtosis gateway instead# List contexts
kurtosis context ls
# Add a remote context
kurtosis context add <context-name>
# Switch to remote context
kurtosis context set <context-name>
# Start portal for the remote context
kurtosis portal start
| Symptom | Cause | Fix |
|---------|-------|-----|
| Portal won't start | Port conflict or stale process | Run kurtosis portal stop then kurtosis portal start |
| Status shows not running | Portal crashed or was killed | Restart with kurtosis portal start |
| Services unreachable via portal | Portal not started for current context | Run kurtosis portal status to check, then kurtosis portal start |
| Connection refused errors | Wrong context or portal not needed | Verify context with kurtosis context ls — local Docker doesn't need portal |
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
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.