// 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.
| name | lint |
| description | 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. |
| compatibility | Requires kurtosis CLI. |
| metadata | {"author":"ethpandaops","version":"1.0"} |
Lint and format Kurtosis Starlark (.star) files.
# Check a single file
kurtosis lint main.star
# Check a directory
kurtosis lint ./my-package/
# Check multiple files
kurtosis lint main.star lib.star helpers.star
Returns non-zero exit code if formatting issues are found.
Fix formatting in place:
kurtosis lint -f main.star
# Format all files in a package
kurtosis lint -f ./my-package/
Validate that the main function has a proper docstring:
kurtosis lint -c ./my-package/main.star
# Or point to the package directory
kurtosis lint -c ./my-package/
This checks that the run function has a valid docstring describing its parameters.
# Check formatting (fails if not formatted)
kurtosis lint ./my-package/
# Check docstrings
kurtosis lint -c ./my-package/
# Fix-and-retry pattern: auto-fix, then re-lint to verify
kurtosis lint -f ./my-package/
kurtosis lint ./my-package/
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.
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.
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.