Documentation

Getting Started

Install Clusterfudge, connect to your first cluster, and start managing resources in under two minutes.

1

Install Clusterfudge

Choose your preferred installation method.

macOS (Homebrew)
$ brew install clusterfudge
Direct download

Download the latest release from the Downloads page or from GitHub Releases.

Build from source
$ git clone https://github.com/leonardaustin/clusterfudge.git
$ cd clusterfudge
$ make build

Requires Go 1.25+ and Node.js 22+.

2

Connect a cluster

Clusterfudge reads your existing kubeconfig automatically. If you already have ~/.kube/config set up, you're ready to go.

Automatic detection

On launch, Clusterfudge discovers all contexts from your kubeconfig. Select any context from the sidebar cluster list to connect.

Custom kubeconfig paths

Go to Settings > Kubeconfig to add additional kubeconfig file paths. Multiple files are merged, just like kubectl.

Pre-flight checks

Clusterfudge performs reachability and authentication validation before connecting, so you get clear error messages instead of timeouts.

3

Navigate with the keyboard

Clusterfudge is keyboard-first. Here are the shortcuts you'll use most.

Cmd+K Open the command palette. Search for anything — resources, actions, views.
G + key Vim-style chord navigation. G P = Pods, G D = Deployments, etc.
Up/Down Navigate table rows. Enter opens detail panel.
L View logs for the selected pod.
X Exec (shell) into the selected pod's container.

Press ? at any time to see the full shortcut reference.

4

Set up AI debugging (optional)

If you have Claude Code, Gemini CLI, or ChatGPT Codex installed, Clusterfudge can use them to debug pod issues.

Configuration

Go to Settings > AI and enable your preferred provider. Clusterfudge auto-detects installed tools.

Usage

Select any pod and click the AI tab in the bottom tray. Clusterfudge gathers context (pod YAML, logs, events) and launches an interactive AI session with all sensitive data automatically redacted.

Next steps