Overview
ClusterDeck is a macOS-first desktop tool for keeping local access to frequently recreated VM and Kubernetes environments stable.
It is not a general Kubernetes management console. Its boundary is the workstation access layer: discover a remote environment, make SSH access usable, fetch and normalize kubeconfig, then verify Kubernetes connectivity.
IP / Host Discovery
↓
SSH Connectivity
↓
SSH Bootstrap (optional)
↓
SSH Alias / ProxyJump
↓
Remote kubeconfig Fetch
↓
kubeconfig Normalization
↓
Local Profile
↓
Kubernetes Connectivity CheckDesign
- Tauri 2 + Rust for filesystem, process execution, SSH orchestration, and kubeconfig handling.
- React + TypeScript for a compact Profile/Host/Connect/Status UX.
- Native OpenSSH first instead of reimplementing SSH behavior.
- Profile-oriented identity so users think in environments rather than changing IP addresses.
- ClusterDeck-owned configuration under
~/.clusterdeck/without rewriting unrelated user SSH/Kubernetes configuration.
Security boundary
Bootstrap passwords are one-time inputs and should not be stored or logged. Generated kubeconfigs use restrictive permissions, and destructive merges to user-managed SSH/Kubernetes configuration are avoided.
Outside ~/.clusterdeck/, ClusterDeck touches exactly four things, each opt-in or confined to its own marked block:
- Login Keychain — trusting a cluster's CA (opt-in per discovered endpoint, or from Settings → Trusted CAs) adds it to your login keychain (never System), scoped to the SSL/TLS trust policy only. Inspect or remove it in Keychain Access.app or from ClusterDeck itself.
/etc/hosts— off by default, opt-in per Profile. When enabled, writes stay inside one marked block per profile (# >>> ClusterDeck BEGIN (profile: <id>) >>>) via an admin-privileged prompt.- Local DNS (v0.5.0, opt-in per Profile) — with
host_mapping: local_dns, ClusterDeck writes only marker-owned/etc/resolver/<zone>files (# managed by ClusterDeck (profile: <id>)) via an admin-privileged prompt and runs a loopback-only DNS responder on127.0.0.1:15353as the user LaunchAgentcom.clusterdeck.dns. It exists for setups where Safari and URLSession ignore/etc/hosts. ~/.ssh/config— gets a singleInclude ~/.clusterdeck/ssh/*.confline; per-profile SSH options live in that included directory, not in your own config.
Download
The latest release, v0.5.0 (2026-10-26), ships as macOS Apple Silicon (aarch64) and Intel (x64) .dmg files (per the CHANGELOG, the Intel build is compiled on an Apple Silicon CI runner and has not been launched on Intel hardware). It is an unsigned, ad-hoc build: there is no Apple Developer ID certificate yet, so macOS shows an "unidentified developer" warning on first launch — right-click the app and choose Open to run it anyway.
v0.5.0 adds built-in local DNS, an app-managed SSH tunnel for bastion-only cluster APIs, and local VM inventory (Colima, VirtualBox, VMware Fusion, Vagrant) with a Demo mode (InfraDeck absorbed into ClusterDeck).
MVP
- Profile CRUD
- Multi-host discovery and SSH bootstrap
- SSH alias generation
- Bastion / ProxyJump
- Remote kubeconfig fetch and normalization
- Per-Profile kubeconfig storage
- Kubernetes connectivity verification
- Minimal-click macOS UI
Cross-platform and provider-specific discovery remain later phases.
Development
pnpm install
pnpm tauri dev
pnpm build
cargo check --manifest-path src-tauri/Cargo.tomlRunning from source remains the recommended path; the .dmg is a secondary distribution channel, not a replacement for it.
Documentation
| Topic | Page |
|---|---|
| Overview | Overview |
| Architecture | Architecture |
| Getting Started | Getting Started |