KubeLoop v1.5.0

Highlights

Active session connectivity tests

KubeLoop can now test active Port Forward, Exchange, Mirror, and Preview sessions directly from the Network view.

• Visual request, response, and mirrored-traffic paths
• Clear indication of the layer where a connectivity check failed
• One-click retesting from the result dialog
• Compact, accessible action buttons and a responsive topology layout

More reliable session lifecycle

• Serialize session lifecycle transitions to avoid overlapping connect and disconnect operations
• Guard concurrent intercept startup and publication
• Keep failed stop operations retryable
• Improve runtime cleanup and state synchronization
• Retry sing-box startup when a local control or DNS port collides
• Restore Wails and Gateway connections more reliably after transient failures

Kubernetes and desktop improvements

• Migrate Service target discovery to EndpointSlices
• Isolate cluster state from unrelated frontend async actions
• Harden async views and form validation
• Improve built-in network diagnostics

Testing and maintainability

• Add local end-to-end runners and broader network diagnostic coverage
• Expand helper, DNS lifecycle, UDP, intercept, and platform test coverage
• Refactor session and intercept internals around clearer runtime boundaries

Install or upgrade

macOS and Linux:

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

Windows PowerShell:

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

macOS with Homebrew:

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

Platform-specific installers, portable archives, Gateway binaries, and SHA256SUMS are attached below.

Full Changelog: v1.4.0...v1.5.0

KubeLoop v1.4.0

What's Changed

• feat(session): integrate traffic metrics and refactor inbound handling by @fengqi-dev in 4e841ba
• chore(deps): update indirect dependencies in go.mod and go.sum by @fengqi-dev in 863a638
• refactor(traffic): streamline traffic handling by removing MirrorPrimary and updating routing logic by @fengqi-dev in b92fa02

Full Changelog: v1.3.2...v1.4.0

KubeLoop v1.3.2

What's Changed

• feat(intercept): implement RecoverControl method for Gateway control channel recovery by @fengqi-dev in 7d4a2e2
• feat(dns): add DNS namespace management and cluster domain support by @fengqi-dev in 73179e3
• chore(e2e): update end-to-end tests and clean up unused files by @fengqi-dev in b8eb271
• feat(network): add copyable IP and address functionality by @fengqi-dev in 0509235
• feat(ci): enhance CI workflow and e2e test setup by @fengqi-dev in 29e9a57
• refactor(docs): update design documentation for DNS handling and UI clarity by @fengqi-dev in 0e3992d
• feat(ci, e2e): enhance CI workflow and add optional cluster probe handling by @fengqi-dev in be6a853
• feat(e2e): refactor test execution and enhance logging by @fengqi-dev in 1068762
• refactor(helper, intercept, session): improve timeout handling and dialer usage by @fengqi-dev in de22d96
• fix(helper): improve DNS resolution handling and timeout management by @fengqi-dev in 681c011
• fix(core): extend timeouts for Linux session handling by @fengqi-dev in 031d71d
• feat(helper): implement link DNS management for Linux sessions by @fengqi-dev in f65e003

Full Changelog: v1.3.1...v1.3.2

KubeLoop v1.3.1

What's Changed

• fix(windows): install helper next to the app directory by @fengqi-dev in abfc736

Full Changelog: v1.3.0...v1.3.1

KubeLoop v1.3.0

What's Changed

• fix: gofmt tray.go and rename Homebrew tap to kube-loop/kubeloop by @fengqi-dev in b4ad9d5
• fix(helper): isolate dev helper identity from release installs by @fengqi-dev in 766c5b3
• feat: add local MCP server and sing-box config viewer by @fengqi-dev in 7aceeff
• docs(site): add MCP guide and cross-links by @fengqi-dev in 20ae3a5

Full Changelog: v1.2.0...v1.3.0

KubeLoop v1.2.0

What's Changed

• New Bauhaus branding, connect control refresh, and macOS packaging/tray fixes by @fengqi-dev in 7862eb4
• Docs: update installation instructions for KubeLoop in README files and improve clarity by @fengqi-dev in e1d94fa

Full Changelog: v1.1.2...v1.2.0

KubeLoop v1.1.2

What's Changed

• Ship Clash Verge-style Windows packaging with pinned sing-box by @fengqi-dev in #2
• Add system tray with hide-to-tray close behavior by @fengqi-dev in #3
• fix: gofmt internal/locale/strings.go by @fengqi-dev in #4
• fix: stage sing-box after wails -clean compile by @fengqi-dev in #5

Full Changelog: v1.1.1...v1.1.2

KubeLoop v1.1.1

What's Changed

• fix: align Linux deb/rpm release artifact names by @fengqi-dev in #1

New Contributors

• @fengqi-dev made their first contribution in #1

Full Changelog: v1.1.0...v1.1.1

v1.1.0

Pre-release

Packaging and Windows helper dry-run for v1.1.0. Not marked as Latest — v1.0.0 remains the recommended stable release until this is promoted.

Highlights

Desktop installers

Release assets now include native installers in addition to portable archives:

Platform	Installer	Portable
Windows	NSIS (kubeloop-*-windows-*-installer.exe)	.zip
macOS	.dmg (drag to Applications)	.tar.gz
Linux	.deb / .rpm	.tar.gz

Artifact names include the version, for example:

• kubeloop-1.1.0-windows-amd64-installer.exe
• kubeloop-1.1.0-darwin-arm64.dmg
• kubeloop_1.1.0_amd64.deb / kubeloop-1.1.0-1.amd64.rpm
• kubeloop-gateway-1.1.0-linux-amd64

Linux packages install /usr/bin/kubeloop plus a desktop entry. Deb depends on GTK3 + WebKit2GTK 4.1; RPM targets Fedora-style gtk3 / webkit2gtk4.1.

Privileged helper (Windows focus)

• Elevated install / command handling for Windows (UAC / PowerShell paths)
• Stronger socket ACL / DACL checks in tests
• Helper lifecycle and session management refactors across platforms
• Optional protocol field on the helper model

Traffic / session datapath

• Traffic dialers integrated into session management
• SOCKS-based local traffic path for enhanced session handling

CI / quality

• Windows self-hosted E2E / integration workflow updates
• More reliable port-forward test logging
• Release pipeline builds NSIS, DMG, deb, and rpm on tag push

Install

1. Download the asset for your OS/arch below (or from SHA256SUMS).
2. macOS: open the DMG and drag KubeLoop.app to Applications. If Gatekeeper blocks it: right-click → Open, or xattr -cr KubeLoop.app.
3. Windows: run the NSIS installer, or extract the zip. If SmartScreen appears: More info → Run anyway.
4. Linux: sudo dpkg -i kubeloop_1.1.0_*.deb or sudo rpm -i kubeloop-1.1.0-1.*.rpm, or extract the tarball and run KubeLoop.
5. Connect with a normal kubeconfig; approve the privileged helper once on first use.

Gateway

• kubeloop-gateway-1.1.0-linux-amd64 / kubeloop-gateway-1.1.0-linux-arm64
• Container image published to GHCR as part of this tag

Notes for testers

Please verify:

• Installer installs and launches on a clean machine
• Uninstall / upgrade path (especially Windows NSIS and Linux packages)
• Helper elevation prompt appears once and reconnects without re-prompt
• Connect / TUN / DNS / port-forward still work after the helper refactor

Feedback and issues: https://github.com/fengqi-dev/kube-loop/issues

Full changelog: v1.0.0...v1.1.0

v1.0.0

KubeLoop v0.1.0

First public release of KubeLoop — a desktop client that connects your laptop to a Kubernetes cluster like a VPN, so local apps can reach Pod IPs, ClusterIP Services, and *.cluster.local without per-app proxies.

Highlights

• One-click cluster network — TUN + split DNS via managed sing-box; only cluster traffic is routed
• In-cluster Gateway — reached through the API Server (port-forward); image ghcr.io/fengqi-dev/kube-loop/gateway:v0.1.0 (also :latest)
• Privileged helper — install once for TUN / DNS / routes (Settings); later connects usually skip elevation
• Network tools — Port Forward, Exchange (Service intercept), Mirror (TCP tee), Preview (temporary ClusterIP)
• Host aliases — per-context domain → IP maps for the tunnel DNS path
• Multi-kubeconfig & limited RBAC — merge kubeconfig files; connect with namespace-scoped accounts when Gateway is preinstalled
• Overview — traffic stats, Kubernetes API version, manual Pod/Service CIDR + Cluster DNS overrides

Platforms

Asset	Notes
kubeloop-darwin-arm64.tar.gz / kubeloop-darwin-amd64.tar.gz	Contains KubeLoop.app + helper
kubeloop-windows-amd64.zip	Desktop app + helper
kubeloop-linux-amd64.tar.gz / kubeloop-linux-arm64.tar.gz	Desktop binary + helper
kubeloop-gateway-linux-*	Standalone Gateway binaries
SHA256SUMS	Checksums for all artifacts

Install

1. Download the archive for your OS/arch from this release.
2. macOS: open KubeLoop.app. If Gatekeeper blocks it, right-click → Open, or run xattr -cr KubeLoop.app.
3. Windows: if SmartScreen appears, More info → Run anyway.
4. Linux: extract and run.
5. Pick a Context → Connect; approve the virtual network service on first use.

Docs: Website · README

Notes

• sing-box is a separately licensed (GPLv3) managed dependency — see THIRD_PARTY_NOTICES.
• Archives are not Apple-notarized / Authenticode-signed yet.

Full Changelog: https://github.com/fengqi-dev/kube-loop/commits/v1.0.0