v0.56.0

Connect to clusters whose kubeconfig depends on a credential helper — aws-vault first — without launching Klustr through a terminal wrapper.

Features

• aws-vault integration. Kubeconfigs whose exec block runs aws eks get-token often rely on ambient credentials that only exist inside an aws-vault exec <profile> -- <tool> wrapper, which a GUI-launched app never sees. A new Credential helpers section on the Connections screen detects aws-vault, lets you map a context to an AWS profile (the profile named in the kubeconfig's --profile argument or AWS_PROFILE env is preselected), and runs aws-vault export for you when the context connects — the usual Keychain or MFA prompt appears, then data flows. Captured credentials live in memory only, are fed to that context's exec plugin, and renew automatically about five minutes before they expire. Mappings persist across restarts (provider and profile names only — never secrets). Failures surface as a toast with a Retry action and a key badge on the context card shows the capture state.
• Login-shell environment import. On GUI launches (Finder, Dock, a .desktop entry) Klustr now imports PATH and a fixed allowlist of variables (AWS_VAULT_BACKEND, AWS_CONFIG_FILE, proxy and CA settings, KUBECONFIG) from your interactive login shell, the way editors like VS Code do — so exec credential plugins resolve and behave exactly as they do in your terminal. Terminal launches are unaffected.

The credential provider interface is generic; aws-vault is the first implementation, with room for granted, saml2aws and friends.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.56.0/klustr-v0.56.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.56.0/klustr-v0.56.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.56.0/klustr_0.56.0_amd64.deb
sudo dpkg -i klustr_0.56.0_amd64.deb

v0.55.0

Resize a running pod's CPU and memory in place — no recreation, no restart unless the container's resizePolicy asks for one.

Features

• In-place pod resize. A Resize action on the pod detail header changes a running container's CPU and memory requests and limits through the pods/resize subresource (KEP-1287, beta and on by default since Kubernetes 1.33), so the pod is not recreated. The dialog loads the container's current requests/limits, lets you edit any subset (blank leaves a value unchanged), and validates the quantities before applying. Multi-container pods get a container picker.
• Resource visibility on pods. The pod Overview containers table now shows CPU and memory request/limit columns, and a banner surfaces an in-flight resize — Deferred (no room on the node yet, retrying) or Infeasible (the node can't satisfy the request).

Hidden in read-only mode.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.55.0/klustr-v0.55.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.55.0/klustr-v0.55.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.55.0/klustr_0.55.0_amd64.deb
sudo dpkg -i klustr_0.55.0_amd64.deb

v0.54.0

Node-level operations land in Klustr: a root shell on any node, plus cordon, uncordon and a PodDisruptionBudget-aware drain — all driving the standard Kubernetes API, with nothing pre-installed in the cluster.

Features

• Node shell. Open a root shell on any node from its detail panel. Klustr launches a temporary, node-pinned, privileged nsenter helper pod that enters the host's namespaces and removes itself when the session ends — no SSH, nothing left behind. It uses the host's bash when present and falls back to sh.
• Cordon / uncordon. One-click toggle of a node's schedulability from the node detail header, with a confirm dialog.
• Drain. Cordon a node and evict its pods through the Eviction API, so PodDisruptionBudgets are honored. DaemonSet-managed and static mirror pods are skipped, PDB-blocked evictions are retried, and live progress — phase, evicted/total, and the pods still pending — streams into the dialog.

All three are hidden in read-only mode.

Fixes

• Node shell on Bottlerocket. Bottlerocket's host shell is a sandboxed shell that refuses an ordinary host session. On Bottlerocket nodes Klustr now runs the shell from the helper image with the host's process, network and IPC namespaces, starting in the live host filesystem at /proc/1/root, so every host process and the whole host filesystem stay reachable.

Maintenance

• Dependency bumps (#24, #25).

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.54.0/klustr-v0.54.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.54.0/klustr-v0.54.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.54.0/klustr_0.54.0_amd64.deb
sudo dpkg -i klustr_0.54.0_amd64.deb

v0.53.0

The Karpenter sidebar group now wears Karpenter's real logo, and the frontend sheds two dependencies for vendored equivalents.

Features

• Official Karpenter logo. The Karpenter group in the sidebar now uses Karpenter's official mark instead of a generic placeholder icon, matching how the Argo CD and Istio groups already show their real logos.

Maintenance

• Smaller dependency footprint. The react-icons and shadcn npm packages are replaced with vendored equivalents — the exact brand glyphs Klustr renders are inlined, and the small shadcn Tailwind preset (accordion keyframes, Radix state variants, the no-scrollbar utility) is inlined verbatim. This drops 288 transitive packages and clears a license-policy flag raised against an icon set bundled inside react-icons that Klustr never used. No visual or behavioral change.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.53.0/klustr-v0.53.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.53.0/klustr-v0.53.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.53.0/klustr_0.53.0_amd64.deb
sudo dpkg -i klustr_0.53.0_amd64.deb

v0.52.0

A server-side dry-run preview before any YAML apply — see exactly what the cluster will do, including defaulting and admission, before a single byte is written.

Features

• Server-side dry-run diff for YAML apply. The Review & apply step now runs a real server-side dry-run and diffs the live object against the result the server predicts — defaulting, admission and mutating webhooks already applied — instead of a plain text diff of your edits. This mirrors the guarantee Helm's --dry-run already gave the rest of Klustr.
• Mistakes are caught before they commit. A change the API server would reject — an immutable field, an admission policy, a quota — surfaces at dry-run and the Apply button stays disabled, so the apply never fails halfway. Kubernetes' verbose invalid/immutable errors (which echo the whole offending object) are collapsed to a readable one-line summary, with the full server response available behind a disclosure.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.52.0/klustr-v0.52.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.52.0/klustr-v0.52.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.52.0/klustr_0.52.0_amd64.deb
sudo dpkg -i klustr_0.52.0_amd64.deb

v0.51.0

First-class cert-manager support, auto-detected when the cert-manager CRDs are present — no cmctl CLI, no extra logins, just your kubeconfig.

Features

• cert-manager integration. A dedicated sidebar group appears when cert-manager is installed, covering the full set of resources:
  • Certificates with ready/expiry status and a one-click Renew action.
  • Issuers and ClusterIssuers with their status and configuration.
  • The complete issuance chain — CertificateRequest → Order → Challenge — listed and viewable on its own.
• Issuance-chain drill-down. From a Certificate, follow the chain across CertificateRequest, Order and Challenge in dedicated detail tabs to see exactly where issuance is stuck, plus the related Events.
• All reads run through watch-backed informers and all actions (Renew) go through the standard Kubernetes API — consistent with the rest of Klustr's pure-client model.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.51.0/klustr-v0.51.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.51.0/klustr-v0.51.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.51.0/klustr_0.51.0_amd64.deb
sudo dpkg -i klustr_0.51.0_amd64.deb

v0.50.2

Maintenance release — dependency and CI updates only. No functional changes.

Dependencies

• Frontend (npm). React / React DOM 19.2.7, TanStack Query 5.101.0, Zustand 5.0.14, lucide-react 1.17.0, Vite 8.0.16, Vitest 4.1.8, ESLint 10.4.1, typescript-eslint 8.60.1, shadcn 4.10.0, @types/react 19.2.16.
• Backend (Go). Masterminds/semver 3.5.0, creack/pty 1.1.24.

CI

• Bumped GitHub Actions: actions/checkout v6, actions/setup-node v6, actions/configure-pages v6, actions/deploy-pages v5, golangci/golangci-lint-action v9.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.50.2/klustr-v0.50.2-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.50.2/klustr-v0.50.2-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.50.2/klustr_0.50.2_amd64.deb
sudo dpkg -i klustr_0.50.2_amd64.deb

v0.50.1

This release exposes the read-only toggle on the welcome screen.

Features

• Read-only toggle on the welcome screen. The read-only switch now also sits in the connections-screen header (beside the theme picker), so you can lock a session before connecting. The choice is pushed to the backend the moment a context is opened, so a cluster comes up read-only from the start.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.50.1/klustr-v0.50.1-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.50.1/klustr-v0.50.1-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.50.1/klustr_0.50.1_amd64.deb
sudo dpkg -i klustr_0.50.1_amd64.deb

v0.50.0

This release adds node metrics and node pressure to the Nodes view.

Features

• Node CPU/memory usage in the Nodes table. Each node row now shows live CPU and memory usage bars (usage against the node's allocatable, colored by saturation) from a 15-second metrics poll. The usage column appears only when metrics-server is available and hides gracefully when it isn't — exactly like the pod usage column.
• Node pressure badges. The Status cell flags active Memory / Disk / PID pressure conditions inline, so a node under pressure (a common root cause of pending pods and evictions) is visible at a glance. Pressure comes from the node's conditions, so it shows even without metrics-server.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.50.0/klustr-v0.50.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.50.0/klustr-v0.50.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.50.0/klustr_0.50.0_amd64.deb
sudo dpkg -i klustr_0.50.0_amd64.deb

v0.49.0

This release adds a read-only mode.

Features

• Read-only mode. A global toggle in the header — an iOS-style switch that follows the active theme's color — with a matching indicator in the status bar, puts Klustr into read-only mode: every mutation (apply, delete, scale, restart, pause, HPA edit, CSR approve/deny, rollout undo, Argo sync/refresh/rollback/automation/delete, Flux reconcile/suspend, and Helm install/upgrade/rollback/uninstall) is refused in the Go backend, not merely hidden in the UI. Because Klustr is a pure client with no in-cluster agent, that backend guard is a hard local guarantee against accidental writes; read paths, live data, and metrics are unaffected. Mutating buttons and menu items are hidden while it's on. The choice persists across restarts and is off by default.
• Header controls regrouped into cluster tools and preferences/leave, separated by a divider, and the theme picker now shows a tooltip on hover.

Install

Homebrew (macOS)

brew install --cask sametkum/klustr/klustr

If you already have Klustr installed:

brew upgrade --cask klustr

Manual (macOS, Apple Silicon)

curl -L https://github.com/SametKUM/klustr/releases/download/v0.49.0/klustr-v0.49.0-darwin-arm64.tar.gz | tar xz
mv Klustr.app /Applications/

Arch Linux

yay -S klustr-bin   # or paru / your preferred AUR helper

Manual (Linux, x86_64)

# .tar.gz
curl -L https://github.com/SametKUM/klustr/releases/download/v0.49.0/klustr-v0.49.0-linux-amd64.tar.gz | tar xz
sudo mv klustr /usr/local/bin/

# or .deb (Debian / Ubuntu)
curl -LO https://github.com/SametKUM/klustr/releases/download/v0.49.0/klustr_0.49.0_amd64.deb
sudo dpkg -i klustr_0.49.0_amd64.deb