brandond/wharfie

Wharfie is a command-line tool that downloads a container image and unpacks it onto your local filesystem. Think of it like unzipping a compressed archive, but for container images. You give it an image name and a destination folder, and it pulls everything down and lays out the files so you can inspect or use them directly. Under the hood, it's built as a Go library on top of another project called go-containerregistry, adding extra features for specific use cases. The tool handles the logistics of authenticating with registries, pulling layers, and unpacking them. It can pull from private registries, read from local tarball files, and cache layers so you don't re-download them. It also supports Kubernetes-style credential provider plugins, which handle authentication for cloud-based registries like AWS, Google Cloud, or Azure. The primary audience appears to be people working with K3s or RKE2, which are lightweight Kubernetes distributions. Those projects use a specific configuration format for private registries, and wharfie reads that same format by default. Someone running a Rancher-based Kubernetes setup might use this tool to manually pull images and inspect their contents, or to cache image layers for environments where bandwidth is limited or a registry connection isn't always available. The project is fairly niche and low-profile, with a single star on GitHub. It serves as both a standalone CLI and a reusable Go module, so other developers could integrate the pulling and unpacking logic into their own tools. The README doesn't go into much detail about real-world workflows or use cases beyond listing the available options.