winget install --id=DavideMaggi.Koncierge -e Koncierge CLI is a command-line tool for managing Kubernetes port forwards. It provides an efficient terminal interface for viewing pods, services, and managing port forwarding sessions.
A modern, cross-platform Kubernetes port-forwarding manager
Features • Installation • Getting Started • Usage • CLI • FAQ • Contributing
Koncierge UI is a cross-platform Kubernetes port-forwarding manager available both as a desktop application (built with .NET MAUI and Blazor) and a command-line interface. It provides an intuitive way to manage multiple port-forwards across different clusters, namespaces, and services without needing to remember complex kubectl commands.
# Install the desktop application (with desktop shortcut)
winget install DavideMaggi.KonciergeUI
# Install the CLI tool
winget install DavideMaggi.Koncierge
# Install the desktop application
choco install konciergeui
# Install the CLI tool
choco install koncierge
Download the latest release from the Releases page:
Desktop Application:
KonciergeUI-setup-X.Y.Z.exe): Recommended, creates desktop shortcut and adds konciergeui to PATHKonciergeUi-win-X.Y.Z.zip): Extract and run KonciergeUI.exeCLI Tool:
Koncierge-cli-setup-X.Y.Z.exe): Adds koncierge command to PATHKoncierge-cli-win-X.Y.Z.zip): Extract and run Koncierge.exeBuild from source (see below) or download platform-specific releases when available.
# Clone the repository
git clone https://github.com/davidemaggi/koncierge-ui.git
cd koncierge-ui
# Restore dependencies
dotnet restore
# Build the solution
dotnet build
# Run the application (Windows)
dotnet run --project KonciergeUi.Client -f net9.0-windows10.0.19041.0
# Run the application (macOS)
dotnet run --project KonciergeUi.Client -f net9.0-maccatalyst
On first launch, click "Add Kubeconfig" to import your Kubernetes configuration file. Koncierge UI will automatically discover all clusters and contexts defined in the file.
Use the cluster dropdown to select which Kubernetes cluster you want to work with.
Navigate through the Pods or Services tabs to view available resources. Use the filters to narrow down by:
Click the "Forward" button on any port to create a new port-forward. Configure:
Once you have configured your forwards, click "Create Template" to save the configuration for future use.
Templates allow you to save and quickly start multiple port-forwards at once.
Navigate to the Active Forwards page to see all running port-forwards. From here you can:
All resource tables support advanced filtering:
koncierge-ui/
├── KonciergeUi.Client/ # MAUI Blazor client application
│ ├── Components/ # Razor components (pages, layouts, modals)
│ ├── Services/ # App services (version provider)
│ ├── State/ # Application state management
│ └── wwwroot/ # Static assets
├── KonciergeUI.Cli/ # Command-line interface application
│ ├── Commands/ # CLI commands (cluster, pods, services, templates)
│ └── Infrastructure/ # DI and CLI infrastructure
├── KonciergeUI.Core/ # Core abstractions and interfaces
├── KonciergeUI.Data/ # Data persistence (preferences, templates)
├── KonciergeUI.Kube/ # Kubernetes integration
│ └── Repositories/ # K8s API wrappers
├── KonciergeUI.Models/ # Shared models and DTOs
├── KonciergeUI.Translations/# Localization resources
├── installer/ # Inno Setup scripts for Windows installers
├── chocolatey/ # Chocolatey package definitions
└── docs/ # Documentation
Koncierge UI also includes a powerful command-line interface for users who prefer terminal-based workflows or need to integrate with scripts and automation.
# Via WinGet (recommended)
winget install DavideMaggi.Koncierge
# After installation, the 'koncierge' command is available globally
koncierge --help
# Run directly with dotnet
dotnet run --project KonciergeUI.Cli
# Or build and run the executable
dotnet build KonciergeUI.Cli
./KonciergeUI.Cli/bin/Debug/net9.0/Koncierge
Start the full interactive menu with all features:
koncierge interactive
# or
koncierge i
The interactive mode provides a guided menu for:
# List all available clusters
koncierge cluster list
# Select a cluster interactively or by name
koncierge cluster select
koncierge cluster select my-cluster
# List pods (with optional namespace and cluster filters)
koncierge pods list
koncierge pods list -n kube-system -c my-cluster
# List services
koncierge services list
koncierge services list -n default
# List secrets and ConfigMaps
koncierge secrets list -n default
koncierge secrets list --show-values
# Create a quick port forward interactively
koncierge forward create
# Create with options
koncierge forward create -n default -t service -r my-service -p 8080 -l 8080
# List active forwards
koncierge forward list
# Stop a forward
koncierge forward stop
koncierge forward stop --all
# List saved templates
koncierge template list
# Run a template
koncierge template run
koncierge template run "My Template" -c my-cluster
# Run with watch mode (shows logs and status updates)
koncierge template run "My Template" --watch
# Stop a running template
koncierge template stop
koncierge template stop --all
# Create a new template interactively
koncierge template create
# 1. List and select a cluster
koncierge cluster list
koncierge cluster select production
# 2. Browse resources
koncierge pods list -n backend
koncierge services list -n backend
# 3. Run a saved template with logging
koncierge template run "Backend Dev" --watch
# 4. Or create a quick forward
koncierge forward create -t service -r api-gateway -p 8080
# 5. View active forwards
koncierge forward list
# 6. Stop when done
koncierge forward stop --all
Q: What Kubernetes versions are supported?
A: Koncierge UI uses the official Kubernetes C# client and supports any cluster version compatible with the client library (typically 1.20+).
Q: Can I use multiple kubeconfig files?
A: Yes! You can add multiple kubeconfig files, and Koncierge UI will aggregate all clusters and contexts.
Q: Where are my settings stored?
A: Settings are stored in a JSON file in your platform's application data folder.
Q: What does "Random" port mean?
A: When you set the local port to 0, the system automatically assigns an available port. The actual port number is displayed once the forward starts.
Q: Why can't I start a template?
A: The "Start Template" button is disabled if any of the configured ports are already in use by another running forward. Check the tooltip for details on which ports conflict.
Q: How does service port forwarding work?
A: When forwarding a service, Koncierge UI resolves the actual pod behind the service and uses the correct targetPort (container port), not the service port.
Q: Why did my forward fail with "connection refused"?
A: This usually means the application inside the pod is not listening on the specified port. Verify the pod is running and the port is correct.
Q: Emoji render as "??" in the CLI on Windows
A: This is usually a console/font limitation. Use Windows Terminal or PowerShell 7, and pick a font with emoji support (for example, Segoe UI Emoji or Cascadia Code PL). If you run from cmd.exe, verify the code page is UTF-8 with chcp 65001.
Q: Resources are not loading after changing clusters
A: Make sure you have proper RBAC permissions on the target cluster. Check the connection logs for detailed error messages.
Q: Theme doesn't apply correctly on startup
A: The theme is resolved after the first render. This is normal behavior to support system theme detection.
Q: Filters persist after changing clusters
A: This was a known issue and has been fixed. Filters now reset automatically when you change clusters.
Contributions are welcome! Please feel free to submit a Pull Request.
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)# Install .NET 9 SDK
# Install MAUI workloads
dotnet workload install maui
# Clone and build
git clone https://github.com/davidemaggi/koncierge-ui.git
cd koncierge-ui
dotnet build
To regenerate the CLI ASCII logo from the SVG:
bash scripts/generate-ascii-logo.sh --help
# Example
bash scripts/generate-ascii-logo.sh --width 72
This project uses GitVersion for automatic semantic versioning. See docs/release-process.md for details.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Me