Get started

Connect your machine to a cluster in a few minutes.

Connect once

Install KubeLoop

Install a platform package from GitHub Releases, or build from source with Wails.

Homebrew

brew tap kube-loop/kubeloop https://github.com/fengqi-dev/kube-loop
brew install --cask kubeloop

Shell

Download the latest DMG for your CPU, then open it and drag KubeLoop.app into Applications.

curl -fsSL https://raw.githubusercontent.com/fengqi-dev/kube-loop/main/scripts/install.sh | bash

Manual

Open the DMG from GitHub Releases and drag KubeLoop.app into Applications. If Gatekeeper blocks it, right-click → Open, or run:

xattr -cr /Applications/KubeLoop.app

Shell

In PowerShell, download and run the latest installer:

irm https://raw.githubusercontent.com/fengqi-dev/kube-loop/main/scripts/install.ps1 | iex

Installer

Run the NSIS installer from GitHub Releases.

Portable

Extract the portable zip and run KubeLoop. If SmartScreen appears, choose More info → Run anyway.

Shell

Download and install the latest .deb/.rpm for your distro:

curl -fsSL https://raw.githubusercontent.com/fengqi-dev/kube-loop/main/scripts/install.sh | bash

Package

Install kubeloop-VERSION-linux-ARCH.deb or .rpm from GitHub Releases.

Tarball

Extract the tar.gz and run the KubeLoop binary from the unpacked directory.

Confirm kubeconfig access

Make sure this machine can reach the cluster API with a normal kubeconfig.

Select a Context and Connect

Open the Clusters page, pick a Context, optionally probe the API, then connect.

Approve the helper once

On first use, approve the virtual network service. Later connects should not ask again.

After you are connected

Use Overview for traffic and status, Workload / Network for Port Forward, Exchange, Mirror, and Preview, and Host Aliases for custom domain → IP maps. Short names like mysql.default resolve via Kubernetes search domains.

Optional: MCP for AI agents

Open the MCP tab, install into Cursor / Claude Code / Codex / VS Code, then refresh MCP in that client. Off by default; localhost only.

MCP

Download releases MCP Product