Skip to content
EliitmePublic

About

Native macOS Kubernetes GUI: browse clusters and CRDs, stream pod logs, open shells, port-forward, edit YAML and kubeconfig, manage Helm releases. Fast SwiftUI app, no Electron, no kubectl needed.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Cluvia Cluvia

A clear view of your Kubernetes world.
A fast, native Kubernetes GUI for macOS to explore, understand and manage your clusters: browse resources and CRDs, stream pod logs, open shells, port-forward, edit YAML and kubeconfig, and manage Helm releases.

Download Cluvia for macOS

CI Release macOS 14+ Swift 6 License: PolyForm Noncommercial 1.0.0 OpenSSF Scorecard Sponsors

Cluvia showing deployments with the detail panel

Features

  • Native and light. SwiftUI and AppKit, no Electron. Watches thousands of objects with a small memory footprint.
  • All your clusters in one sidebar. Every context from your kubeconfig, grouped by file, with favorites, connection state and per-cluster color badges. Keep several clusters connected and switch instantly.
  • Live resource browser. Every built-in kind and your CRDs, kept up to date with watches, with filters (name, label=value, status:running), namespace selection and CPU/memory columns from metrics-server.
  • Detail panel. Status at a glance, conditions, containers, usage charts (from Prometheus), YAML and events.
  • Actions. Logs (one pod or a whole workload), shell, port-forward, edit YAML with diff and dry run (server-side apply), scale, restart, cordon, drain, node shell and delete, each with a keyboard shortcut.
  • Built-in terminal and logs. Shells and port-forwards run inside the app over the Kubernetes API: no kubectl required. Logs highlight errors and warnings.
  • Kubeconfig editing. Add contexts by form, from a file or by pasting YAML; edit, rename, delete and set the current context. Edits go to the file that defines each entry, keep fields Cluvia does not know about, and save a backup first.
  • Helm. Browse releases, values, manifests and history (needs the helm CLI).
  • Command palette (⌘K) to jump to any kind, namespace, object or cluster.

Cluvia streaming pod logs in the bottom panel

Works with

Any conformant Kubernetes cluster your kubeconfig can reach: Amazon EKS, Google GKE, Azure AKS, DigitalOcean, Rancher and k3s, kind, minikube, Docker Desktop, OpenShift and self-managed clusters. Authentication with client certificates, tokens and credential plugins (aws, gke-gcloud-auth-plugin, kubelogin, OIDC helpers) works as in kubectl.

Install

With Homebrew:

brew install --cask eliitme/tap/cluvia

Or download the latest DMG from Releases and drag Cluvia to Applications. Requires macOS 14 or later. Releases are signed with a Developer ID and notarized by Apple.

Cluvia updates itself: it checks for new versions daily (you can turn this off) and under Cluvia › Check for Updates…. Updates are verified with an EdDSA signature before they are installed.

  • Cluvia reads your kubeconfig (~/.kube/config or the KUBECONFIG list, as kubectl does).
  • Credential plugins (cloud CLIs, OIDC helpers) run from your login shell's PATH.
  • helm is optional; without it the Helm section shows an install hint.
  • CPU/memory columns need metrics-server; usage charts use an in-cluster Prometheus (detected, or set per cluster).

About kubeconfig changes

Cluvia only writes to your kubeconfig when you add, edit, import or delete a context, or set the current context. Before each write it takes the same lock as kubectl, refuses to overwrite a file that changed on disk, and keeps a timestamped backup next to the file (config.cluvia-backup-…). Comments in the file are not preserved.

FAQ

Does Cluvia need kubectl? No. Cluvia talks to the Kubernetes API directly, including logs, shells (exec) and port-forwarding. Credential plugins referenced by your kubeconfig still need to be installed.

Is Cluvia free? Yes, for noncommercial use under the PolyForm Noncommercial License. For commercial use, please get in touch.

Does Cluvia send my data anywhere? No. It connects only to your clusters (and Prometheus inside them for usage charts). There is no account, telemetry or cloud service.

Which macOS versions are supported? macOS 14 Sonoma and later, on Apple silicon and Intel.

macOS says the app cannot be opened. Builds that are not yet notarized need a one-time approval: open System Settings › Privacy & Security and click Open Anyway next to the Cluvia message.

Build from source

brew install xcodegen
xcodebuild -downloadComponent MetalToolchain
xcodegen generate
open Cluvia.xcodeproj

See CONTRIBUTING.md for tests, project layout and release packaging.

Contributing

Issues, ideas and pull requests are welcome. Please read the contributing guide and the code of conduct. Report security issues privately as described in SECURITY.md.

Thanks to everyone who has contributed:

Contributors

Support the project

Cluvia is built in spare time. If it saves you time, consider supporting its development:

License

Cluvia is source-available under the PolyForm Noncommercial License 1.0.0: you may use, study, modify and share it for any noncommercial purpose. Commercial use requires a separate license; please get in touch.

Brand assets (logo, icon) in Brand/ identify the official project; please do not use them for forks or other products. The wordmark is set in Outfit (SIL Open Font License 1.1).

About

Native macOS Kubernetes GUI: browse clusters and CRDs, stream pod logs, open shells, port-forward, edit YAML and kubeconfig, manage Helm releases. Fast SwiftUI app, no Electron, no kubectl needed.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages