Credential access
Reads kubeconfig, local cluster config, and registry settings.
brew
Install ctlptl with Homebrew, Nix, zypper
Making local Kubernetes clusters fun and easy to set up. Version 0.9.4 via Homebrew; verified 2026-06-04.
agent safety
Agent safety answer
ctlptl manages local Kubernetes clusters and container registry wiring.
Remote mutation
Primarily local, but can affect reachable Kubernetes contexts.
Publish/artifact risk
Can change local cluster state used for builds and deploy tests.
Recommended control
Gate cluster create/delete and registry mutation commands.
Agent-use guidance
Allow status and config review; require approval for cluster lifecycle changes.
install
Additional install commands
macOS
Homebrewverified · 100%
brew install ctlptllocal Homebrew formula metadata
Linux
Nixverified · 92%
nix profile install nixpkgs#ctlptlnixpkgs package indexes · pkgs/by-name/ct/ctlptl/package.nix · source: api.github.com
openSUSE zypperverified · 92%
sudo zypper install ctlptlopenSUSE Tumbleweed package metadata · ctlptl · source: download.opensuse.org
overview
Package summary
Making local Kubernetes clusters fun and easy to set up
Project links
Commands and aliases
- ctlptl
history
Project history and usage
ctlptl is a Tilt-developed CLI for declaratively creating and managing local Kubernetes clusters. It uses Kubernetes-style YAML to drive local cluster products such as Docker Desktop, kind, k3d, and minikube.
Project history
The README says ctlptl was inspired by kubectl and Cluster API's clusterctl, with the idea that users declare a local cluster in YAML and let the CLI set it up. Tilt created it after helping teams debug repeated local-development environment misconfigurations.
The project reached v0.1.0 in November 2020 and has continued as a 0.x tool, with official release artifacts reaching v0.9.4 in June 2026.
Adoption history
Official installation paths include Homebrew on macOS and Linux, Scoop on Windows, and go install. The README emphasizes interoperability with common local Kubernetes products rather than replacing them.
How it is used
Common commands include ctlptl get, create cluster, apply -f cluster.yaml, and delete -f cluster.yaml. Typical package use is in developer-workstation setup scripts and CI-friendly local-cluster recipes where a registry, CPU limits, Kubernetes version, or Docker Desktop setting needs to be repeatable.
Why package nerds care
ctlptl is packaging glue for the local Kubernetes stack: it wraps existing cluster implementations, exposes declarative YAML, and provides package-manager-friendly binaries for developers who want reproducible local infrastructure without maintaining bespoke shell scripts.
Timeline
- 2020: v0.1.0 release published.
- 2020: Early releases added declarative local-cluster workflows around kind, k3d, minikube, and Docker Desktop.
- 2026: v0.9.4 release published.
Related projects
- ctlptl is explicitly related to kubectl, Cluster API's clusterctl, kind, k3d, minikube, Docker Desktop, and Tilt's local-development tooling.
Sources
security posture
Risk level: orange
infrastructure mutation or orchestration signal.
Risk classifier
orange risk · medium confidence · infrastructure
Why
- infrastructure mutation or orchestration signal
Signals
- text:kubernetes,cluster
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
cluster.yaml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
ctlptl | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version0.9.4
manager updated2026-06-04
local dataok
upstreamcurrent
latest detectedv0.9.4
https://github.com/tilt-dev/ctlptl
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:ctlptl |
|---|---|
| Version | 0.9.4 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/ctlptl |
| Homepage | https://github.com/tilt-dev/ctlptl |
| Repository | https://github.com/tilt-dev/ctlptl |
| Upstream docs | https://github.com/tilt-dev/ctlptl#readme |
| License | Apache-2.0 |
| Source archive | https://github.com/tilt-dev/ctlptl/archive/refs/tags/v0.9.4.tar.gz |
| Last updated | 2026-06-04T03:05:20Z |
| Pulse | updated |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | ctlptl |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
ctlptl
nix profile install nixpkgs#ctlptl- normalized package name match
- Matched by: Ctlptl
zypper95%
ctlptl 0.9.4-1.1
CLI for declaratively setting up local Kubernetes clusters
https://github.com/tilt-dev/ctlptl
sudo zypper install ctlptl- License: Apache-2.0
- Category: Unspecified
- Architecture: x86_64
- Source Package: ctlptl
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Ctlptl
zypper95%
ctlptl-bash-completion 0.9.4-1.1
Bash Completion for ctlptl
https://github.com/tilt-dev/ctlptl
sudo zypper install ctlptl-bash-completion- License: Apache-2.0
- Category: System/Shells
- Architecture: noarch
- Source Package: ctlptl
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Ctlptl
zypper95%
ctlptl-fish-completion 0.9.4-1.1
Fish Completion for ctlptl
https://github.com/tilt-dev/ctlptl
sudo zypper install ctlptl-fish-completion- License: Apache-2.0
- Category: System/Shells
- Architecture: noarch
- Source Package: ctlptl
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Ctlptl
zypper95%
ctlptl-zsh-completion 0.9.4-1.1
Zsh Completion for ctlptl
https://github.com/tilt-dev/ctlptl
sudo zypper install ctlptl-zsh-completion- License: Apache-2.0
- Category: System/Shells
- Architecture: noarch
- Source Package: ctlptl
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Ctlptl
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated agent safety answer
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment