Kubernetes troubleshooting that explains why, not just what.
Full documentation is published at gabor-boros.github.io/klue.
To build and preview locally: make docs-serve.
go install github.com/gabor-boros/klue@latestor
brew install --cask gabor-boros/brew/klueOr download a prebuilt binary from the releases page.
klue --help
klue version
klue why pod <name> -n <namespace>
klue why certificate <name> -n <namespace>Requires Go 1.26+. Run make help to list all available targets.
make build # build the binary into ./bin
make run ARGS=... # run the CLI with arguments
make test # run tests
make lint # run golangci-lint
make fmt # format the code
make ci # tidy + vet + lint + race tests
make changelog # regenerate CHANGELOG.md from git historyThis project uses pinned versions of the following tools:
| Tool | Version | Purpose |
|---|---|---|
| GoReleaser | v2.16.0 | Build and publish releases |
| git-cliff | v2.12.0 | Changelog generation |
| golangci-lint | v2.12.2 | Linting and formatting |
| pre-commit | 4.6.0 | Git hook management |
Install the Go-based tooling and set up git hooks:
make tools # install golangci-lint, goreleaser, and git-cliff
make pre-commit # install and run pre-commit hooksReleases are automated via GoReleaser and GitHub Actions. Push a semantic version tag to trigger a release:
git tag v0.1.0
git push origin v0.1.0Validate the release configuration and build a local snapshot:
make release-check
make snapshotklue is licensed under the Apache License 2.0.